跳转到主要内容

​
概述

Catalog API 是一套电商解决方案，使广告主能够设置产品供稿、将产品分组为集合，并以整体方式管理目录中的产品。Catalog API 将成为实现程序化目录管理的核心工具，帮助广告主更好地控制目录的导入与更新。 目录包含与用户的产品及产品集合相关的全部内容，并与该用户的 handle 关联。目前，一个用户只能创建一个目录。  Catalog API 支持两种产品导入方式：
  1. 定时供稿：用户可添加供稿 URL（CSV、TSV 和 XML），系统将定期抓取（X 目前支持最大 8GB 的文件）
  2. 批量产品 API：用户可通过批量（JSON）请求查看、创建、更新和删除产品属性
X 商家可以基于筛选规则创建产品集合。通过这种方式，他们可以为产品附加额外的元数据，并创建特别的产品集合，以通过自然电商功能或动态产品广告展示这些产品。Catalog API 与 X Shopping Manager 支持两种类型的产品集合。 
  1. 手动：用户最多可选择 50 个产品，并设置名称和描述
  2. 筛选：用户最多可添加 30 个筛选条件，自动生成满足条件的产品集合。筛选类型包括价格、Google 产品类别、产品类型、库存、促销价以及自定义字段。
Catalog API 提供 4 个用于管理目录的端点：

​
Catalog API 的使用前提

Catalog API 的端点目前仅提供早期访问。要申请开通，请联系您的 X 代表。 您需要通过 X Shopping Manager 同意服务条款。 有关 Shopping Manager 和产品规范的详情，请参阅 产品规范指南。

​
速率限制 

下表列出了各端点的速率限制。

​
产品目录

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_feeds每 15 分钟 1,000 次
POST /product_catalogs/:product_catalog_id/product_feeds每 15 分钟 20 次
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id每 15 分钟 20 次
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id每 15 分钟 20 次