Verwaltung von CSS-Labels

Wir möchten die Betaversion der Merchant API einführen. Es handelt sich um die neue Version des Content API for Shopping und in Zukunft

Informationen dazu, wie Sie mit der Merchant API Ihre Integration verbessern können und wie Sie die siehe Ankündigung der Merchant API Beta.

Preisvergleichsportale können im Namen von Preisvergleichsportalen Shopping-Anzeigen auf Google schalten von Händlern in Ländern, in denen das Programm für Preisvergleichsportale verfügbar ist. Content API ermöglicht es Preisvergleichsportal-Domains und Preisvergleichsportal-Gruppen, ihre verknüpften Konten mithilfe von Labels. Preisvergleichsportal-Domains können Merchant Center-Konten auflisten, mit Labels versehen und filtern die mit der Domain verknüpft sind. Preisvergleichsportal-Gruppen können Preisvergleichsportal-Domains mit Labels versehen und auflisten die mit der Gruppe verknüpft sind. Diese Content API-Dienste bieten programmatische Funktionen, die im Preisvergleichs- Servicecenter.

Weitere Informationen zu Preisvergleichsportalen finden Sie unter Preisvergleichsportale Informationen zum Arbeiten mit Labels im CSS Center finden Sie unter Kontolabels im Comparison Shopping Service Center verwenden

Kontotypen für Preisvergleichsportale

Preisvergleichsportale verwenden die folgenden drei Arten von Konten:

• Preisvergleichsportal-Gruppen sind die Konten der obersten Ebene, die ein oder mehrere Preisvergleichsportale enthalten können Domains.
• Preisvergleichsportal-Domains sind die Konten der Preisvergleichsportale selbst, die Shopping-Anzeigen Anzeigen im Namen von Händlern schalten. Jede Preisvergleichsportal-Domain kann nur einer Preisvergleichsportal-Gruppe angehören.
• Merchant Center-Konten sind die Händler, für die Preisvergleichsportal-Domains platziert werden. Shopping-Anzeigen Preisvergleichsportale können mit verschiedenen Händlertypen verknüpft werden Center-Konten, einschließlich Mehrfachkundenkonten (MCAs) und einzelner Händler Konten. Jedes Merchant Center-Konto kann nur mit einem Preisvergleichsportal verknüpft werden . Weitere Informationen zu den verschiedenen Arten von Merchant Center-Konten Siehe Kontotypen im Comparison Shopping Service Center

CSS-Labeltypen

Preisvergleichsportale verwenden zwei Arten von Labels:

• Manuelle Labels werden vom Preisvergleichsportal erstellt und Merchant Center-Konten zugewiesen. und zu Preisvergleichsportal-Domains nach Preisvergleichsportal-Gruppen.
• Automatische Labels werden automatisch erstellt und dem Merchant Center zugewiesen. im CSS Center verwalten. Automatische Labels sind für verschiedene Kontomesswerten und können wichtige Konten und wichtige Kontoaktivität.

Weitere Informationen zu Labeltypen, einschließlich der verfügbaren automatischen finden Sie unter Kontolabels im Comparison Shopping Service Center verwenden

Content API-Funktionen und Endpunkte für Preisvergleichsportale

Die Content API bietet die folgenden Endpunkte für Preisvergleichsportale:

• accounts.labels: Erlaubt Sie können Labels erstellen, abrufen und ändern, um sie auf die Preisvergleichsportal-Domain und den Händler anzuwenden. Center-Konten. Ein Beispiel finden Sie unter Labels erstellen.
• accounts.updatelabels: Damit können Sie Labels auf ein einzelnes Merchant Center-Konto anwenden. Ein Beispiel: Weitere Informationen
• accounts.list: Erlaubt alle Merchant Center-Konten abrufen, die mit einer Preisvergleichsportal-Domain verknüpft sind, einschließlich der auf jedes Konto angewendeten Labels. Sie können auch nach dem Label id filtern um eine Teilmenge der verknüpften Konten abzurufen. Ein Beispiel finden Sie unter Merchant Center-Konten mithilfe von Labels filtern
• accounts.get: Erlaubt können Sie die Labels abrufen, die auf ein einzelnes Merchant Center-Konto angewendet wurden.
• csses: Hier können Sie sich die Verknüpfungen zwischen Labels und Preisvergleichsportal-Domains verwalten. Ein Beispiel finden Sie unter Labels auf eine Preisvergleichsportal-Domain anwenden

Beim Aufrufen von accounts-Endpunkten als CSS-Domain ist Folgendes zu beachten: Anforderungen:

• Preisvergleichsportal-Domains müssen ihre cssId anstelle von merchantId angeben.
• Preisvergleichsportal-Domains müssen den Suchparameter view=CSS angeben.
• Preisvergleichsportal-Domains müssen die zugehörige Merchant Center-Konto-ID angeben: accountId

Hinweis: Labels können nur in Konten von Preisvergleichsportal-Domains und Preisvergleichsportal-Gruppen verwendet werden. Die Merchant Center-Konten selbst haben keinen Zugriff auf das Label Funktionalität.

Beispiel: Label erstellen

Mit der Methode accounts.labels.create können Sie ein neues Label erstellen. Etiketten kann auf Preisvergleichsportal-Domains und Merchant Center-Konten angewendet werden. Labels für Die verschiedenen Kontotypen sind separate Kontotypen und können nicht synonym verwendet werden. Bis Ein Label auf Domainebene erstellen, das auf Merchant Center-Konten angewendet werden kann die mit der Domain verknüpft ist, verwenden Sie die Preisvergleichsportal-Domain-ID als accountId, wenn beim Erstellen des Labels. Um ein Label auf Gruppenebene zu erstellen, das auf CSS angewendet werden kann Domains, die mit der Gruppe verknüpft sind, verwenden Sie die Preisvergleichsportal-Gruppen-ID als accountId, wenn beim Erstellen des Labels.

Das folgende Beispiel zeigt, wie Schlüsselkonten auf Domainebene erstellt werden. das dann auf Merchant Center-Konten angewendet werden kann, die mit dem . Um das Label zu erstellen, senden Sie eine POST-Anfrage mit der folgenden URL und Anfragetext:

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

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

Beispiel: Label auf ein Merchant Center-Konto anwenden

Sie können die Methode accounts.updatelabels verwenden, um einem Händler Labels zuzuweisen Center-Konto, das mit einer Preisvergleichsportal-Domain verknüpft ist. Im folgenden Beispiel sehen Sie, wie das im vorherigen Beispiel erstellte Label key-accounts auf ein Konto angewendet wird, Ihrer wichtigsten Merchant Center-Konten.

Hinweis: Sie müssen die id des Labels verwenden, nicht den Namen, wenn Sie ein Label auf ein Merchant Center-Konto. Die id wird automatisch dem Label und die in der Antwort zurückgegeben wird, wenn das Label erstellt wird. Sie können auch den Rufen Sie dazu accounts.labels.list auf, um das Label „id“ zu kennzeichnen.

Um das Label anzuwenden, senden Sie eine POST-Anfrage mit der folgenden URL und einer Anfrage Text:

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

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

Beispiel: Merchant Center-Konten mithilfe von Labels filtern

Nach dem Erstellen und Anwenden von Labels auf die verknüpften Merchant Center-Konten nicht mit einer Preisvergleichsportal-Domain verknüpft ist, können Sie die Methode accounts.list verwenden und das Label in Ihrer Anfrage verwenden, um nur die Konten mit diesem Label zurückzugeben. Die Das folgende Beispiel zeigt, wie die Merchant Center-Konten gefiltert werden. die mit einer Preisvergleichsportal-Domain verknüpft sind, unter Verwendung der id (123) der Schlüsselkonten Label, das im Beispiel Label erstellen erstellt wurde. Um den Konto, senden Sie eine GET-Anfrage mit der folgenden URL:

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

Es ist kein Anfragetext erforderlich.

Beispiel: Label auf eine Preisvergleichsportal-Domain anwenden

Sie können auch die Methode csses.updatelabels verwenden, um einem Preisvergleichsportal Labels zuzuweisen Domain, die mit einer Preisvergleichsportal-Gruppe verknüpft ist. Das folgende Beispiel zeigt, wie Sie Wenden Sie ein Label key-domains auf Gruppenebene an, das mithilfe der accounts.labels.create-Methode zu einer Ihrer wichtigsten Preisvergleichsportal-Domain Konten. Beachten Sie, dass Labels für Preisvergleichsportal-Domains und Merchant Center-Konten getrennt sind. Labels auf Gruppenebene müssen mit einer Preisvergleichsportal-Gruppen-ID als accountId

Hinweis: Sie müssen die id des Labels verwenden, nicht den Namen, wenn Sie ein Label auf eine Preisvergleichsportal-Domain. id wird dem Label automatisch zugewiesen und in die Antwort, wenn das Label erstellt wird. Sie können das Label id auch abrufen, indem Sie accounts.labels.list wird angerufen.

Um das Label anzuwenden, senden Sie eine POST-Anfrage mit der folgenden URL und einer Anfrage Text:

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

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