跳转到主要内容

​
概览

Catalog API 是一套商务解决方案，使广告主能够设置产品数据源、将产品分组为集合，并以整体方式管理目录中的产品。Catalog API 将成为实现目录程序化管理的核心工具，让广告主对目录的导入与更新拥有更高的可控性。 目录包含与用户的产品及产品集有关的全部信息，并与该用户的 handle 关联。目前，每位用户仅可创建一个目录。 Catalog API 支持两种产品导入方式：
  1. Scheduled Feed：用户可以添加数据源 URL（CSV、TSV 和 XML），系统将定期抓取（X 目前支持最大 8GB 的文件）
  2. Batch Products API：用户可以通过批量（JSON）请求查看、创建、更新和删除产品属性
X 商家可以基于筛选规则创建产品集。通过这种方式，他们可以为产品附加额外的元数据，并创建特殊的产品集，以通过自然电商功能或动态商品广告展示这些产品。Catalog API 和 X Shopping Manager 支持两种类型的产品集。
  1. Manual：用户最多可选择 50 个产品，并设置名称和描述
  2. Filter：用户最多可添加 30 个筛选条件，以自动生成满足这些条件的产品集。筛选类型包括价格、Google 产品类别、产品类型、库存、促销价和自定义字段。
Catalog API 提供 4 个用于管理目录的 endpoint：
  • Product Catalogs - 创建用于承载产品信息的容器
  • Products -  同步添加、更新、查看并从目录中移除产品
  • Product Sets -  基于产品信息将产品分组归类
  • Schedule Feeds - 设置将基于文件的产品数据异步导入至目录

​
Catalog API 的先决条件

Catalog API 的 endpoint 目前仅限早期访问。要申请访问，请联系你的 X 代表。 你需要通过 X Shopping Manager 同意服务条款。 有关 Shopping Manager 和产品规范的详细信息，请参阅产品规范指南。

​
请求速率限制 

下表列出了各个 endpoint 的请求速率限制。

​
产品目录

HTTP 方法请求速率限制
GET /product_catalogs每 15 分钟 1,000 次
POST /product_catalogs每 15 分钟 20 次
PUT /product_catalogs/:product_catalog_id每 15 分钟 20 次
DELETE /product_catalogs/:product_catalog_id每 15 分钟 20 次

​
批量产品 API

HTTP 方法请求速率限制
GET /product_catalogs/:product_catalog_id/products每 15 分钟 1,000 次
PUT /product_catalogs/:product_catalog_id/products每 15 分钟 600 次
DELETE /product_catalogs/:product_catalog_id/products每 15 分钟 150 次

​
产品集

HTTP 方法请求速率限制
GET /product_catalogs/:product_catalog_id/product_sets每 15 分钟 2,000 次
POST /product_catalogs/:product_catalog_id/product_sets每 15 分钟 100 次
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id每 15 分钟 500 次
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id每 15 分钟 100 次

​
产品数据馈送

HTTP 方法请求速率限制
GET /product_catalogs/:product_catalog_id/product_feeds15 分钟内最多 1,000 次
POST /product_catalogs/:product_catalog_id/product_feeds15 分钟内最多 20 次
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15 分钟内最多 20 次
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id15 分钟内最多 20 次
⌘I