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. Esta opción puede utilizarse en los países donde está disponible el programa de CSS. Content API permite que los dominios y los grupos de CSS organicen sus cuentas asociadas con etiquetas. Los dominios de CSS pueden enumerar, etiquetar y filtrar las cuentas de Merchant Center asociadas con el 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 Comparison Shopping Service Center.

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 comercio 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 cuenta en Comparison Shopping Service Center.

Tipos de etiquetas de CSS

Los CSS usan dos tipos de etiquetas:

  • Los dominios de CSS crean y asignan etiquetas manuales a las cuentas de Merchant Center, y los grupos de CSS a los dominios de CSS.
  • CSS Center crea y asigna etiquetas automáticas a las cuentas de Merchant Center de forma automática. Las etiquetas automáticas están disponibles para diferentes tipos de métricas de la cuenta y pueden ayudarte a identificar cuentas importantes y actividades significativas 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 Content API para CSS

Content API ofrece los siguientes extremos para los CSS:

Cuando llames a extremos 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: Cómo crear 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 están separadas 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: Cómo aplicar 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 de cuentas clave 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 la solicitud:

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

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

Ejemplo: Cómo usar 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 etiqueta en tu solicitud para mostrar solo las cuentas con esa etiqueta. En el siguiente ejemplo, se muestra cómo filtrar las cuentas de Merchant Center asociadas con un dominio de CSS, usando el id (123) de la etiqueta de cuentas clave creada en el ejemplo 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 cuerpo de la solicitud.

Ejemplo: Cómo aplicar 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 de dominios clave a nivel del grupo 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 están separadas. 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 la solicitud:

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

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