[lightMode]

Attach Youtube Video

POST/products/{product}/video

[updatedIn] 2 months ago

This endpoint allows you to add unlimited videos to a specific product by passing the product as a path parameter.

:::caution[Alert]

Videos must be added as Youtube links.
You can only add one video per request.
:::

`products.read_write`- Products Read & Write

Request

Authorization: OAuth 2.0

Add the parameter

Authorization

to [header]，whose value is to concatenate the Token after the Bearer.

[api.label.example]

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

[message.pathParameter]

product

integer

required

The Product ID. List of Product ID can be found here.

video_url

string

required

A web address that links to a specific video file or content on the interne. | required

default

boolean

optional

Set the video thumbnail image as default for product.

alt

string

optional

Alternative description for the video thumbnail image to enhance SEO.

{
  "video_url": "https://www.youtube.com/watch?v=dmqWuUeA5Ug",
  "default": true,
  "alt": "things from Google"
}

Request samples

[api.label.responses]

Attached Successfully(201)

Not Found(404)

Error Validation(422)

Attached Successfully

HTTP Code: 201

Content Type : JSONapplication/json

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (ProductImagesVideos)

optional

number

required

A unique identifier associated with the product image.

Example:

1908361139

image

object

required

sort

number

required

Sort Order

Example:

default

boolean

required

Whether or not the image the default picture

Default:

false

alt_seo

string | null

required

Alternative SEO Text for the image

video_url

string

required

Video web address.

type

string

required

Attachment Type

Example:

image

{
  "status": 201,
  "success": true,
  "data": {
    "id": 1749963998,
    "image": {
      "original": {
        "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/maxresdefault.jpg",
        "width": 1920,
        "height": 1080
      },
      "standard_resolution": {
        "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/sddefault.jpg",
        "width": 640,
        "height": 480
      },
      "low_resolution": {
        "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/mqdefault.jpg",
        "width": 320,
        "height": 180
      },
      "thumbnail": {
        "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/default.jpg",
        "width": 120,
        "height": 90
      }
    },
    "default": true,
    "alt_seo": "Introducing a few new helpful things from Google",
    "video_url": "https://www.youtube.com/watch?v=dmqWuUeA5Ug",
    "type": "video"
  }
}

[updatedIn] 2 months ago