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 el programa de CSS está disponible. Content API permite que los dominios y grupos de CSS organicen sus cuentas asociadas mediante 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 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 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 CSS

Los CSS usan dos tipos de etiquetas:

  • Las etiquetas manuales se crean y asignan a cuentas de Merchant Center mediante los dominios de CSS, y a los dominios de CSS mediante los grupos de CSS.
  • Las etiquetas automáticas se crean y asignan automáticamente a las cuentas de Merchant Center mediante CSS Center. Las etiquetas automáticas están disponibles para diferentes tipos de métricas de las cuentas y pueden ayudarte a identificar las cuentas importantes y una 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 Content API para los CSS

Content API ofrece los siguientes extremos para los CSS:

Cuando llames a extremos accounts como un 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 su ID de cuenta de Merchant Center asociado 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 dominios de CSS y cuentas de Merchant Center. Sin embargo, las etiquetas para los diferentes tipos de cuenta son independientes y no se pueden usar indistintamente. Para crear una etiqueta a nivel de dominio, que se pueda aplicar a las cuentas de Merchant Center asociadas con el dominio, usa el ID de dominio de CSS como accountId cuando crees la etiqueta. Para crear una etiqueta a nivel de 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 de 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 el 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 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 el cuerpo de la solicitud:

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

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

Ejemplo: Use etiquetas para filtrar las 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 etiquetas en tu solicitud para que se muestren 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 mediante el id (123) de la etiqueta clave-cuentas creada en el ejemplo Crea 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 el cuerpo de la 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 de grupo de dominios de clave 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 de grupo deben crearse con un ID de grupo de CSS como su accountId.

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

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

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