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 el Comparison Shopping Service Center.

Consulta Servicios de comparación de productos para obtener más información sobre los CSS. 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 utilizan los siguientes tres tipos de cuenta:

  • 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 ubican los anuncios de Shopping en nombre de los comercios. Cada dominio de CSS puede pertenecer a un solo grupo de CSS.
  • Las cuentas de Merchant Center son los comercios para los que los dominios de CSS colocan anuncios de Shopping. Los CSS se pueden asociar con varios tipos diferentes de cuentas de Merchant Center, incluidas cuentas de varios clientes (MCA) y cuentas de comercios 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, a través de grupos de CSS.
  • CSS Center crea automáticamente las etiquetas automáticas y las asigna a las cuentas de Merchant Center. Las etiquetas automáticas están disponibles para diferentes tipos de métricas de cuenta y pueden ayudarte a identificar cuentas importantes y actividad de cuenta significativa.

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.

Funciones y extremos de Content API para 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 merchantId.
  • Los dominios de CSS deben proporcionar un parámetro de búsqueda 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 de 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 pueda 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 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: Aplique 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 búsqueda de etiquetas 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 a un dominio de CSS mediante el id (123) de la etiqueta de cuentas clave 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 ningún 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 de grupo de dominios clave creada con el método accounts.labels.create a una de las cuentas de dominio de CSS más importantes. Ten en cuenta que las etiquetas de los dominios de CSS y de 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’
}