Se usó la API de Cloud Translation para traducir esta página.

Comienza a usar la API de Merchant

En esta página, se explica cómo 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.

Si usas la integración de la API en Apps Script 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.

Ir a Google Cloud

Crear una cuenta

Para usar la API de Merchant, debes tener una cuenta de Merchant Center. Para crear una, consulta Primeros pasos en Merchant Center.

Ir a Merchant Center

Registrarse como desarrollador

Para usar la API de Merchant, debes crear un vínculo entre tu proyecto de Google Cloud y tu cuenta principal de Merchant Center. Este registro único es obligatorio para cada proyecto de Google Cloud que uses con la API de Merchant.

Registrarse como desarrollador tiene dos propósitos:

Vincula tu proyecto de Google Cloud a tu cuenta principal de Merchant Center, lo que establece una conexión formal.
Crea un contacto técnico asignando el rol de API_DEVELOPER a un usuario de tu cuenta de Merchant Center. Esto permite que Google te envíe actualizaciones importantes sobre la API, como anuncios de servicio e información sobre funciones nuevas.

Registra tu proyecto de Google Cloud

Para registrarte, llama al método developerRegistration.registerGcp. Esta llamada vincula el proyecto de Google Cloud que usas para realizar la llamada con la cuenta de Merchant Center que especificas en la solicitud.

En el cuerpo de la solicitud, debes proporcionar una dirección de correo electrónico del desarrollador para usarla como contacto técnico. Esta dirección debe estar asociada a una Cuenta de Google (cuenta de Google Workspace o cuenta de Gmail), por ejemplo, sampleuser@gmail.com. No se pueden usar cuentas de servicio porque son cuentas no humanas destinadas al acceso programático y no a la comunicación con los desarrolladores.

Si la dirección de correo electrónico ya pertenece a un usuario de la cuenta de Merchant Center, se le otorga el rol de API_DEVELOPER.
Si la dirección de correo electrónico no pertenece a un usuario existente, se envía una invitación a esa dirección. El destinatario debe aceptar la invitación para agregarse como usuario nuevo con el rol de API_DEVELOPER.

A continuación, se muestra una solicitud de ejemplo:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Una llamada exitosa devuelve un recurso DeveloperRegistration, que confirma la vinculación entre tu proyecto y tu cuenta.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Administra los permisos y los contactos de desarrolladores

Después de registrarte, te recomendamos que agregues varios desarrolladores y les otorgues derechos de acceso adicionales.

Otorga permisos adicionales

El rol de API_DEVELOPER es necesario para recibir notificaciones importantes, pero tiene permisos mínimos en Merchant Center. Para permitir que este usuario realice otras llamadas a la API o administre la configuración en la IU de Merchant Center, debes otorgarle roles adicionales, como STANDARD o ADMIN. Para obtener más información, consulta Tipos de acceso.

Puedes actualizar los derechos de acceso de un usuario con el método accounts.users.patch.

En el siguiente ejemplo, se muestra cómo actualizar un usuario para otorgarle los roles de ADMIN y API_DEVELOPER. Esto les permite administrar la cuenta por completo y también recibirán comunicaciones relacionadas con la API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Agrega desarrolladores de copias de seguridad

Para evitar que se interrumpa tu acceso a la API si tu contacto principal de desarrollador deja tu organización, debes agregar al menos un desarrollador de respaldo.

Puedes agregar un usuario con el método accounts.users.create o actualizar uno existente con el método accounts.users.patch. Te recomendamos que le otorgues a este usuario los roles de ADMIN y API_DEVELOPER.

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/v1/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "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 ejecutar esta solicitud correctamente, deberías ver la siguiente respuesta:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Copia el valor del campo name. Lo necesitarás para insertar un producto.

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/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "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.