Gestion des libellés CSS

Les services de comparateur de prix peuvent diffuser des annonces Shopping sur Google pour le compte de marchands situés dans des pays où le programme CSS (Comparison Shopping Services, aussi appelé SCP, services de comparateur de prix) est disponible. Content API permet aux domaines CSS et aux groupes CSS d'organiser les comptes qui leur sont associés à l'aide de libellés. Les domaines CSS peuvent répertorier les comptes Merchant Center qui leur sont associés, leur attribuer des libellés et les filtrer. Les groupes CSS peuvent répertorier les domaines CSS qui leur sont affiliés et leur attribuer des libellés. Ces services Content API fournissent des équivalents programmatiques pour certaines fonctionnalités disponibles dans Comparison Shopping Service Center.

Pour en savoir plus sur les CSS, consultez la page Services de comparateur de prix. Pour savoir comment utiliser les libellés dans CSS Center, consultez la page Utiliser des libellés de compte dans Comparison Shopping Service Center.

Types de comptes SCP

Les SCP utilisent les trois types de comptes suivants :

• Les groupes SCP sont les comptes de niveau supérieur qui peuvent contenir un ou plusieurs domaines SCP.
• Les domaines SCP correspondent aux comptes des SCP eux-mêmes, qui diffusent des annonces Shopping pour le compte des marchands. Chaque domaine CSS ne peut appartenir qu'à un seul groupe CSS.
• Les comptes Merchant Center sont les comptes des marchands pour lesquels les domaines CSS diffusent des annonces Shopping. Les SCP peuvent être associés à différents types de comptes Merchant Center, y compris des multicomptes (MC) et des comptes marchands individuels. Chaque compte Merchant Center ne peut être associé qu'à un seul domaine SCP. Pour en savoir plus sur les différents types de comptes Merchant Center, consultez la page Types de comptes dans Comparison Shopping Service Center.

Types de libellés CSS

Les CSS utilisent deux types de libellés :

• Les libellés manuels sont créés et attribués aux comptes Merchant Center par des domaines CSS, et aux domaines CSS par des groupes CSS.
• Les libellés automatiques sont automatiquement créés et attribués aux comptes Merchant Center par CSS Center. Ils sont disponibles pour différents types de métriques de compte et peuvent vous aider à identifier les comptes importants et leur activité.

Pour en savoir plus sur les types de libellés, y compris sur les libellés automatiques disponibles, consultez la page Utiliser des libellés de compte dans Comparison Shopping Service Center.

Fonctionnalités et points de terminaison Content API pour les CSS

Content API propose les points de terminaison suivants pour les CSS :

• accounts.labels permet de créer, de récupérer et de modifier des libellés à appliquer au domaine CSS et aux comptes Merchant Center. Pour obtenir un exemple, consultez la section Créer un libellé.
• accounts.updatelabels permet d'appliquer des libellés à un seul compte Merchant Center. Pour obtenir un exemple, consultez la section Appliquer un libellé à un compte Merchant Center.
• accounts.list permet de lister tous les comptes Merchant Center associés à un domaine CSS, y compris les libellés appliqués à chaque compte. Vous pouvez également filtrer sur l'id de libellés pour récupérer un sous-ensemble de comptes associés. Pour obtenir un exemple, consultez la section Utiliser des libellés pour filtrer les comptes Merchant Center.
• accounts.get permet de récupérer les libellés appliqués à un seul compte Merchant Center.
• csses permet d'afficher et de gérer les associations entre les libellés et les domaines CSS. Pour obtenir un exemple, consultez la section Appliquer un libellé à un domaine CSS.

Lorsque vous appelez des points de terminaison accounts en tant que domaine CSS, tenez compte des exigences suivantes :

• Les domaines SCP doivent fournir leur cssId au lieu d'un merchantId.
• Les domaines SCP doivent fournir le paramètre de requête view=CSS.
• Les domaines CSS doivent fournir leur ID de compte Merchant Center associé comme accountId.

Remarque : Seuls les comptes de domaine CSS et de groupe CSS peuvent utiliser des libellés. Les comptes Merchant Center n'ont pas accès à cette fonctionnalité.

Exemple : Créer un libellé

Vous pouvez utiliser la méthode accounts.labels.create pour créer un libellé. Les libellés peuvent être appliqués aux domaines CSS et aux comptes Merchant Center. Toutefois, les différents types de comptes utilisent des libellés distincts, qui ne sont pas interchangeables. Pour créer un libellé de niveau domaine, qui peut être appliqué aux comptes Merchant Center associés au domaine, utilisez l'ID de domaine CSS comme accountId lors de la création du libellé. Pour créer un libellé de niveau groupe, qui peut être appliqué aux domaines CSS affiliés au groupe, utilisez l'ID de groupe CSS comme accountId lors de la création du libellé.

L'exemple suivant montre comment créer un libellé "key-accounts" de niveau domaine, qui peut ensuite être appliqué aux comptes Merchant Center associés à ce domaine. Pour créer le libellé, exécutez une requête POST à l'aide de l'URL et du corps de requête suivants :

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

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

Exemple : Appliquer un libellé à un compte Merchant Center

Vous pouvez utiliser la méthode accounts.updatelabels pour attribuer des libellés à un compte Merchant Center associé à un domaine CSS. L'exemple ci-dessous montre comment appliquer le libellé key-accounts créé dans l'exemple précédent à l'un de vos comptes Merchant Center les plus importants.

Remarque : Lorsque vous appliquez un libellé à un compte Merchant Center, vous devez utiliser son id, et non pas son nom. L'id est automatiquement attribué au libellé et renvoyé dans la réponse lorsque le libellé est créé. Vous pouvez également récupérer l'id du libellé en appelant accounts.labels.list.

Pour appliquer le libellé, exécutez une requête POST à l'aide de l'URL et du corps de requête suivants :

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

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

Exemple : Utiliser des libellés pour filtrer les comptes Merchant Center

Après avoir créé et appliqué des libellés aux comptes Merchant Center associés à un domaine CSS, vous pouvez utiliser la méthode accounts.list et ajouter le paramètre de libellé à votre requête afin de ne lister que les comptes associés à un libellé donné. L'exemple ci-dessous montre comment filtrer les comptes Merchant Center associés à un domaine CSS en utilisant l'id (123) du libellé key-accounts créé dans l'exemple de la section Créer un libellé. Pour récupérer les comptes, exécutez une requête GET à l'aide de l'URL suivante :

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

Aucun corps de requête n'est nécessaire.

Exemple : Appliquer un libellé à un domaine CSS

Vous pouvez attribuer des libellés à un domaine CSS affilié à un groupe CSS à l'aide de la méthode csses.updatelabels. L'exemple suivant montre comment appliquer un libellé key-domains de niveau groupe créé à l'aide de la méthode accounts.labels.create à l'un de vos comptes de domaine CSS les plus importants. Sachez que les libellés des domaines CSS et des comptes Merchant Center sont distincts. Les libellés de niveau groupe doivent être créés en utilisant un ID de groupe CSS comme accountId.

Remarque : Lorsque vous appliquez un libellé à un domaine CSS, vous devez utiliser son id, et non pas son nom. L'id est automatiquement attribué au libellé et affiché dans la réponse lorsque le libellé est créé. Vous pouvez également récupérer l'id du libellé en appelant accounts.labels.list.

Pour appliquer le libellé, exécutez une requête POST à l'aide de l'URL et du corps de requête suivants :

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

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