En esta página, se explica cómo crear una cuenta de Merchant Center y subir un producto de muestra con la API de Merchant.
Antes de comenzar
Habilita la API de Merchant en tu proyecto de Google Cloud.
Si la integración de la API se usa en AppScript con el servicio de contenido de Shopping, se crea un proyecto de Google Cloud predeterminado y se habilita el servicio de la API de Merchant automáticamente. Sin embargo, aún debes completar un registro único de desarrollador antes de usar la API de Merchant. Para obtener más información, consulta Cómo usar el servicio de la API de Merchant en Apps Script.
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.
Registrarse como desarrollador
Para usar la API de Merchant, debes vincular tu cuenta de Merchant Center y tu proyecto de Google Cloud con el método de registro de desarrollador, de la siguiente manera:
Vincula Merchant Center y tu proyecto de Google Cloud: La vinculación se aprueba automáticamente, ya que el llamador tiene un token de acceso o una clave de API válidos del proyecto de Google Cloud y es un usuario autorizado de la cuenta de Merchant Center.
Agrega un usuario desarrollador de la API a la cuenta de Merchant Center: La API de registro agrega un usuario desarrollador de la API a la cuenta de Merchant Center. Si ya existe un usuario, se le otorgará el nuevo tipo de acceso. En el caso de un usuario nuevo, recibirá una invitación por correo electrónico de Merchant Center.
Te recomendamos que uses el método accounts.users.create para agregar desarrolladores de API adicionales o de respaldo y verificar que, en caso de que la persona deje tu organización o se borre, aún puedas tener un registro de desarrollador válido.
Después del registro, puedes ver el estado con GetDeveloperRegistration o cancelar el registro con UnregisterGCP.
La llamada de registro es
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
Después de que la solicitud se ejecute correctamente, espera la siguiente respuesta:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
Después de registrar al desarrollador de la API, puedes usar el método accounts.users.patch para otorgarle roles adicionales, como STANDARD y ADMIN.
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 de la API de Merchant. El Explorador de APIs usa Google OAuth 2.0 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 autenticarte con OAuth 2.0, debes acceder a tu Cuenta de Google y, luego, 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
o
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
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.