En esta página, se explica cómo puedes crear una cuenta de Merchant Center y subir un producto de muestra con Merchant API.
Antes de comenzar
Habilita la API de Merchant en tu proyecto de Google Cloud.
Crear una cuenta
Para usar la API de Merchant, debes tener una cuenta de Merchant Center. Para crear una cuenta de Merchant Center, consulta Cómo comenzar a usar Merchant Center.
Obtén el ID de tu cuenta
Puedes obtener el ID de la cuenta con el método accounts.list.
Puedes usar el Explorador de APIs de Google para ejecutar solicitudes a la API de Merchant. El Explorador de APIs usa OAuth 2.0 de Google para la autenticación. Antes de ejecutar las solicitudes, asegúrate de que la casilla de verificación Google OAuth 2.0 esté marcada.
Para autenticar con OAuth 2.0, debes acceder a tu Cuenta de Google y, luego, acceder al Explorador de APIs. También debes permitir que el Explorador de APIs administre tus fichas de productos y cuentas.
En la siguiente solicitud, se muestra cómo puedes recuperar el ID de tu cuenta:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Después de que la solicitud se ejecute correctamente, verás la siguiente respuesta:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Copia el {ACCOUNT_ID} porque lo necesitarás para ejecutar otras solicitudes.
Crea una fuente de datos de productos principal
Para insertar un producto, necesitas una fuente de datos de productos principal. En la siguiente solicitud, se muestra cómo crear una fuente de datos que puedes usar para insertar un producto en tu cuenta:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1
{
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"contentLanguage": "en",
"countries": [
"US"
],
"feedLabel": "US"
},
"name": "primary-data-source",
"displayName": "Primary Products Data Source"
}
Reemplaza {ACCOUNT_ID} por el ID de la cuenta de Merchant Center que creaste.
Después de que se ejecute correctamente esta solicitud, verás la siguiente respuesta:
{
"name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
"dataSourceId": "{DATASOURCE_ID}",
"displayName": "Primary Products Data Source",
"primaryProductDataSource": {
"channel": "ONLINE_PRODUCTS",
"feedLabel": "US",
"contentLanguage": "en",
"countries": [
"US"
],
"defaultRule": {
"takeFromDataSources": [
{
"self": true
}
]
}
},
"input": "API"
}
Copia el valor del campo name porque lo necesitarás para insertar un producto.
La fuente de datos creada tarda unos minutos en estar disponible para insertar productos.
Puedes ver esta fuente de datos en la IU de Merchant Center. Para obtener más información, consulta Cómo encontrar la pestaña Fuentes de datos.
Insertar un producto
Para insertar un producto de muestra en tu cuenta, ejecuta la siguiente solicitud:
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1
{
"channel": "ONLINE",
"contentLanguage": "en",
"feedLabel": "US",
"name": "Red T-shirt",
"attributes": {
"gender": "Male",
"brand": "New brand"
},
"offerId": "tshirt-123"
}
Reemplaza {DATASOURCE_NAME} por el valor que copiaste antes.
Después de que se ejecute correctamente esta solicitud, verás la siguiente respuesta:
{
"name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
"product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
"channel": "ONLINE",
"offerId": "tshirt-123",
"contentLanguage": "en",
"feedLabel": "US",
"attributes": {
"brand": "New brand",
"gender": "Male"
}
}
El ID del producto recién creado es online~en~US~tshirt-123. Puedes usar el método accounts.products.get para recuperar detalles sobre este producto. También puedes usar la IU de Merchant Center para ver este producto.