Administración de etiquetas CSS

Los Servicios de comparación de productos (CSS) pueden publicar anuncios de Shopping en Google en nombre de los comercios en los países donde está disponible el programa de CSS. La Content API permite que los dominios y grupos de CSS organicen sus cuentas asociadas con etiquetas. Los dominios de CSS pueden crear fichas, etiquetar y filtrar las cuentas de Merchant Center asociadas al dominio. Los grupos de CSS pueden etiquetar y enumerar los dominios de CSS afiliados al grupo. Estos servicios de Content API proporcionan equivalentes programáticos a algunas de las funciones disponibles en el Centro de servicios de comparación de productos.

Para obtener más información sobre los CSS, consulta Servicios de comparación de productos. Para obtener información sobre cómo trabajar con etiquetas en CSS Center, consulta Usa etiquetas de cuenta en Comparison Shopping Service Center.

Tipos de cuentas de CSS

Los CSS usan los siguientes tres tipos de cuentas:

  • Los grupos de CSS son las cuentas de nivel superior que pueden contener uno o varios dominios de CSS.
  • Los dominios de CSS son las cuentas de los CSS, que publican anuncios de Shopping en nombre de los comercios. Cada dominio de CSS solo puede pertenecer a un grupo de CSS.
  • Las cuentas de Merchant Center son los comercios para los que los dominios de CSS publican anuncios de Shopping. Los CSS se pueden asociar con varios tipos diferentes de cuentas de Merchant Center, incluidas las cuentas de varios clientes (MCA) y las cuentas de comerciante individuales. Cada cuenta de Merchant Center solo se puede asociar con un dominio de CSS. Para obtener más información sobre los diferentes tipos de cuentas de Merchant Center, consulta Tipos de cuentas en Comparison Shopping Service Center.

Tipos de etiquetas de CSS

Los CSS usan dos tipos de etiquetas:

  • Los etiquetados manuales son creados y asignados a las cuentas de Merchant Center por los dominios de CSS, y a los dominios de CSS por los grupos de CSS.
  • Las etiquetas automáticas se crean y se asignan automáticamente a las cuentas de Merchant Center a través de CSS Center. Las etiquetas automáticas están disponibles para diferentes tipos de métricas de la cuenta y pueden ayudarte a identificar las cuentas importantes y la actividad significativa de la cuenta.

Para obtener más información sobre los tipos de etiquetas, incluidas las etiquetas automáticas disponibles, consulta Usa etiquetas de cuenta en Comparison Shopping Service Center.

Funcionalidad y extremos de la API de Content para los CSS

La API de Content ofrece los siguientes endpoints para los CSS:

Cuando llames a los extremos de accounts como dominio de CSS, ten en cuenta los siguientes requisitos:

  • Los dominios de CSS deben proporcionar su cssId en lugar de un merchantId.
  • Los dominios de CSS deben proporcionar un parámetro de consulta de view=CSS.
  • Los dominios de CSS deben proporcionar el ID de su cuenta de Merchant Center asociada como accountId.

Ejemplo: Crea una etiqueta

Puedes usar el método accounts.labels.create para crear una etiqueta nueva. Las etiquetas se pueden aplicar a los dominios de CSS y a las cuentas de Merchant Center. Sin embargo, las etiquetas para los diferentes tipos de cuentas son independientes y no se pueden usar de forma indistinta. Para crear una etiqueta a nivel del dominio, que se puede aplicar a las cuentas de Merchant Center asociadas con el dominio, usa el ID del dominio de CSS como accountId cuando crees la etiqueta. Para crear una etiqueta a nivel del grupo, que se puede aplicar a los dominios de CSS afiliados al grupo, usa el ID del grupo de CSS como accountId cuando crees la etiqueta.

En el siguiente ejemplo, se muestra cómo crear una etiqueta de cuentas clave a nivel del dominio, que luego se puede aplicar a las cuentas de Merchant Center asociadas con el dominio. Para crear la etiqueta, realiza una solicitud POST con la siguiente URL y cuerpo de la solicitud:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Ejemplo: Aplica una etiqueta a una cuenta de Merchant Center

Puedes usar el método accounts.updatelabels para asignar etiquetas a una cuenta de Merchant Center asociada con un dominio de CSS. En el siguiente ejemplo, se muestra cómo aplicar la etiqueta key-accounts creada en el ejemplo anterior a una de tus cuentas de Merchant Center más importantes.

Para aplicar la etiqueta, realiza una solicitud POST con la siguiente URL y cuerpo de solicitud:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

Ejemplo: Usa etiquetas para filtrar cuentas de Merchant Center

Después de crear y aplicar etiquetas a las cuentas de Merchant Center asociadas con un dominio de CSS, puedes usar el método accounts.list y pasar el parámetro de consulta de la etiqueta en tu solicitud para devolver solo las cuentas con esa etiqueta. En el siguiente ejemplo, se muestra cómo filtrar las cuentas de Merchant Center asociadas a un dominio de CSS con la etiqueta id (123) de key-accounts creada en el ejemplo de cómo crear una etiqueta. Para recuperar las cuentas, realiza una solicitud GET con la siguiente URL:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

No se necesita un cuerpo de solicitud.

Ejemplo: Aplica una etiqueta a un dominio de CSS

También puedes usar el método csses.updatelabels para asignar etiquetas a un dominio de CSS afiliado a un grupo de CSS. En el siguiente ejemplo, se muestra cómo aplicar una etiqueta a nivel del grupo key-domains creada con el método accounts.labels.create a una de tus cuentas de dominio de CSS más importantes. Ten en cuenta que las etiquetas para los dominios de CSS y las cuentas de Merchant Center son independientes. Las etiquetas a nivel del grupo se deben crear con un ID de grupo de CSS como su accountId.

Para aplicar la etiqueta, realiza una solicitud POST con la siguiente URL y cuerpo de solicitud:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}