Puedes usar la API de Merchant para subir y administrar tus productos de manera programática. El recurso accounts.products
te permite crear un catálogo de la tienda en línea, que es una lista de productos y ofertas. Para obtener más información sobre cómo subir y administrar tus productos con la API de Merchant Center, consulta Descripción general de la API de Merchant Products.
Cambios en los recursos
Los recursos products
y productstatuses
de la API de Content se reemplazan por los recursos productInputs
y products
.
Puedes usar el recurso productInputs
de la API de Merchant para subir la información de tus productos. El recurso product
de la API de Merchant se puede usar para recuperar tus productos procesados, incluidos los estados.
Requisitos de la fuente de datos
En la API de Merchant, debes especificar la fuente de datos de destino cuando subas productos. Puede ser una fuente de datos principal o complementaria. Puedes recuperar tus fuentes de datos existentes con dataSources.list o crear una nueva con dataSources.create.
Como alternativa, puedes usar la IU de Merchant Center para administrar tus fuentes de datos.
Para obtener más información sobre las fuentes de datos y cómo crearlas y administrarlas, consulta la Descripción general de la API de Merchant Data Sources.
Cambios en los identificadores
La API de Merchant usa name para identificar el producto. El nombre del producto seguirá el formato accounts/{account}/products/{product}
, en el que {product}
tiene el formato channel~language~feedLabel~offerId
.
Los recursos de Content API usaban :
en lugar de ~
entre cada valor del ID: channel:language:feedLabel:offerId
.
Todas las llamadas a la API de Merchant muestran el formato nuevo con ~
entre los valores del ID. Te recomendamos que almacenes el nuevo campo name
de la respuesta y lo uses en
tus llamadas futuras.
Métodos
A continuación, se muestra una comparación de los métodos de productos en Content API for Shopping y la API de Merchant Products:
Content API for Shopping | API de Merchant Products |
---|---|
products.custombatch | No disponible |
products.insert | productInputs.insert |
products.update | Aún no está disponible |
products.delete | productInputs.delete |
products.get | products.get |
products.list | products.list |
productstatuses.custombatch | No disponible |
productstatuses.get | products.get |
productstatuses.list | products.list |
Solicitudes
Método de Content API | URL en Content API for Shopping | URL en la API de Merchant Products | Identificador en Content API | Identificador en la API de Merchant Products |
---|---|---|---|---|
products.insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products |
POST https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/productsInputs:insert?dataSource=accounts/ {MERCHANT_ID}/dataSources/ {DATASOURCE_ID} |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
No disponible | ||
products.delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
DELETE https://merchantapi.googleapis.com/products/v1beta/ {NAME}?dataSource=accounts/ {MERCHANT_ID}/dataSources/ {DATASOURCE_ID} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |