Merge branch 'main' into promo-1050-new-shipping-action

Author: bc-luke

docs/storefront/graphql/examples/products.mdx

@@ -598,6 +598,117 @@ You can query product images at different resolutions. The following query retri
   </Tab>
 </Tabs>
 
+## Get product videos
+
+The following example retrieves video titles and URLs associated with videos attached to a product.  
+
+<Tabs items={['Request', 'Response']}>
+<Tab>
+```graphql filename="Example query: Get product videos for a product" showLineNumbers copy
+  query {
+    site {
+      products (entityIds: [112, 113]) {
+        pageInfo {
+            startCursor
+            endCursor
+        }
+        edges {
+              cursor
+              node {
+                  entityId
+                  name
+                  videos {
+                    pageInfo {
+                        startCursor
+                        endCursor
+                        hasNextPage
+                        hasPreviousPage
+                    }
+                    edges {
+                        cursor
+                        node {
+                            title
+                            url
+                        }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+```
+
+  </Tab>
+  <Tab>
+
+```json filename="Example response: Get product videos for a product" showLineNumbers copy
+{
+    "data": {
+        "site": {
+            "products": {
+                "pageInfo": {
+                    "startCursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                    "endCursor": "YXJyYXljb25uZWN0aW9uOjM="
+                },
+                "edges": [
+                    {
+                        "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                        "node": {
+                            "entityId": 112,
+                            "name": "Product_112",
+                            "videos": {
+                                "pageInfo": {
+                                    "startCursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                    "endCursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                    "hasNextPage": false,
+                                    "hasPreviousPage": false
+                                },
+                                "edges": [
+                                    {
+                                        "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                        "node": {
+                                            "title": "What is BigCommerce",
+                                            "url": "https://www.youtube.com/watch?v=Vx0OmcMSWGQ&t=8s"
+                                        }
+                                    }
+                                ]
+                            }
+                        }
+                    },
+                    {
+                        "cursor": "YXJyYXljb25uZWN0aW9uOjE=",
+                        "node": {
+                            "entityId": 113,
+                            "name": "Product_113",
+                            "videos": {
+                                "pageInfo": {
+                                    "startCursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                    "endCursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                    "hasNextPage": false,
+                                    "hasPreviousPage": false
+                                },
+                                "edges": [
+                                    {
+                                        "cursor": "YXJyYXljb25uZWN0aW9uOjA=",
+                                        "node": {
+                                            "title": "BigCommerce is enterprise ecommerce, simplified.",
+                                            "url": "https://www.youtube.com/watch?v=vAZ0e5lomfk"
+                                        }
+                                    }
+                                ]
+                            }
+                        }
+                    }                         
+                ]
+            }
+        }
+     }
+}
+```
+  </Tab>
+</Tabs>
+
 ## Get product metafields
 
 Query product metafields by specifying the product metafield's namespace. The API returns only metafields that have storefront permissions. Permissions must be set to `write_and_sf_access` or `read_and_sf_access`. To set permissions, use the [Update a product metafield](/docs/rest-catalog/products/metafields#update-a-product-metafield) endpoint.