Betreiber von Preisvergleichsportalen können im Namen von Händlern in Ländern, in denen das Programm für Preisvergleichsportale verfügbar ist, Shopping-Anzeigen auf Google platzieren. Mit der Content API können Preisvergleichsportal-Domains und Preisvergleichsportal-Gruppen ihre verknüpften Konten mithilfe von Labels organisieren. Mit Preisvergleichsportal-Domains können die mit der Domain verknüpften Merchant Center-Konten aufgelistet, mit Labels versehen und gefiltert werden. Preisvergleichsportal-Gruppen können die mit der Gruppe verbundenen Preisvergleichsportal-Domains mit Labels versehen und auflisten. Diese Content API-Dienste bieten programmatische Entsprechungen zu einigen Funktionen, die im Comparison Shopping Service Center verfügbar sind.
Weitere Informationen zu Preisvergleichsportalen finden Sie unter Preisvergleichsportale. Informationen zur Verwendung von Labels im CSS Center finden Sie unter Kontolabels im Comparison Shopping Service Center verwenden.
Preisvergleichsportal-Kontotypen
Preisvergleichsportale verwenden die folgenden drei Kontotypen:
- Preisvergleichsportal-Gruppen sind die Konten der obersten Ebene, die eine oder mehrere Preisvergleichsportal-Domains enthalten können.
- Preisvergleichsportal-Domains sind die Konten für die Preisvergleichsportale selbst, über die im Namen der Händler Shopping-Anzeigen platziert werden. Jede Preisvergleichsportal-Domain kann nur zu einer Preisvergleichsportal-Gruppe gehören.
- Merchant Center-Konten sind die Händler, für die Preisvergleichsportal-Domains Shopping-Anzeigen platzieren. Preisvergleichsportale können mit verschiedenen Arten von Merchant Center-Konten verknüpft werden, einschließlich Mehrfachkundenkonten (MCAs) und individuelle Händlerkonten. Jedes Merchant Center-Konto kann nur mit einer Preisvergleichsportal-Domain verknüpft werden. Weitere Informationen zu den verschiedenen Arten von Merchant Center-Konten finden Sie unter Kontotypen im Comparison Shopping Service Center.
CSS-Labeltypen
Preisvergleichsportale verwenden zwei Arten von Labels:
- Manuelle Labels werden von Preisvergleichsportal-Domains erstellt und den Merchant Center-Konten zugewiesen. Preisvergleichsportal-Domains werden dagegen von Preisvergleichsportal-Gruppen zugewiesen.
- Automatische Labels werden vom CSS Center automatisch erstellt und Merchant Center-Konten zugewiesen. Automatische Labels sind für verschiedene Arten von Kontomesswerten verfügbar und helfen Ihnen, wichtige Konten und Kontoaktivitäten zu identifizieren.
Weitere Informationen zu Labeltypen, einschließlich der verfügbaren automatischen Labels, 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
: Hiermit können Sie Labels erstellen, abrufen und ändern, um sie auf Preisvergleichsportal-Domain- und Merchant Center-Konten anzuwenden. Ein Beispiel finden Sie unter Label erstellen.accounts.updatelabels
: Hiermit können Sie Labels auf ein einzelnes Merchant Center-Konto anwenden. Ein Beispiel finden Sie unter Label auf ein Merchant Center-Konto anwenden.accounts.list
: Ermöglicht das Abrufen aller Merchant Center-Konten, die mit einer Preisvergleichsportal-Domain verknüpft sind, einschließlich der auf jedes Konto angewendeten Labels. Sie können auch nach dem Labelid
filtern, um einen Teil der verknüpften Konten abzurufen. Ein Beispiel finden Sie unter Labels zum Filtern von Merchant Center-Konten verwenden.accounts.get
: Ermöglicht das Abrufen der Labels, die auf ein einzelnes Merchant Center-Konto angewendet werden.csses
: ermöglicht das Aufrufen und Verwalten der Verknüpfungen zwischen Labels und Preisvergleichsportal-Domains. Ein Beispiel finden Sie unter Label auf eine Preisvergleichsportal-Domain anwenden.
Wenn Sie accounts
-Endpunkte als Preisvergleichsportal-Domain aufrufen, müssen Sie die folgenden Anforderungen beachten:
- Preisvergleichsportal-Domains müssen ihre
cssId
anstelle einermerchantId
angeben. - Preisvergleichsportal-Domains müssen den Abfrageparameter
view=CSS
angeben. - Preisvergleichsportal-Domains müssen die zugehörige Merchant Center-Konto-ID als
accountId
angeben.
Beispiel: Label erstellen
Mit der Methode accounts.labels.create
können Sie ein neues Label erstellen. Labels können auf Preisvergleichsportal-Domains und Merchant Center-Konten angewendet werden. Die Labels für die verschiedenen Kontotypen sind jedoch separate und können nicht austauschbar verwendet werden. Wenn Sie ein Label auf Domainebene erstellen möchten, das auf Merchant Center-Konten angewendet werden kann, die mit der Domain verknüpft sind, verwenden Sie beim Erstellen des Labels die Preisvergleichsportal-Domain-ID als accountId
. Wenn Sie ein Label auf Gruppenebene erstellen möchten, das auf mit der Gruppe verknüpfte Preisvergleichsportal-Domains angewendet werden kann, verwenden Sie beim Erstellen des Labels die Preisvergleichsportal-Gruppen-ID als accountId
.
Im folgenden Beispiel wird gezeigt, wie Sie ein Schlüsselkontolabel auf Domainebene erstellen, das dann auf die mit der Domain verknüpften Merchant Center-Konten angewendet werden kann. Um das Label zu erstellen, senden Sie eine POST
-Anfrage mit der folgenden URL und dem folgenden 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
Mit der Methode accounts.updatelabels
können Sie Labels einem Merchant Center-Konto zuweisen, das mit einer Preisvergleichsportal-Domain verknüpft ist. Das folgende Beispiel zeigt, wie Sie das im vorherigen Beispiel erstellte Label key-accounts auf eines Ihrer wichtigsten Merchant Center-Konten anwenden.
Um das Label anzuwenden, stellen Sie eine POST
-Anfrage mit der folgenden URL und dem Anfragetext:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
Beispiel: Labels zum Filtern von Merchant Center-Konten verwenden
Nachdem Sie Labels erstellt und auf die Merchant Center-Konten angewendet haben, die mit einer Preisvergleichsportal-Domain verknüpft sind, können Sie mit der Methode accounts.list
den Label-Abfrageparameter in Ihrer Anfrage übergeben, damit nur die Konten mit diesem Label zurückgegeben werden. Das folgende Beispiel zeigt, wie Sie die Merchant Center-Konten, die mit einer Preisvergleichsportal-Domain verknüpft sind, mithilfe des id
(123
) des Labels Schlüsselkonten filtern, das im Beispiel Label erstellen erstellt wurde. Stellen Sie eine GET
-Anfrage mit der folgenden URL, um die Anmeldedaten abzurufen:
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 Labels auch mit der Methode csses.updatelabels
einer Preisvergleichsportal-Domain zuweisen, die mit einer Preisvergleichsportal-Gruppe verknüpft ist. Im folgenden Beispiel wird gezeigt, wie Sie ein Label auf Gruppenebene key-domains, das mit der Methode accounts.labels.create
erstellt wurde, auf eines Ihrer wichtigsten Konten von Preisvergleichsportal-Domains anwenden. Hinweis: Labels für Preisvergleichsportal-Domains und Merchant Center-Konten sind voneinander getrennt. Labels auf Gruppenebene müssen mit einer Preisvergleichsportal-Gruppen-ID als accountId
erstellt werden.
Um das Label anzuwenden, stellen Sie eine POST
-Anfrage mit der folgenden URL und dem Anfragetext:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}