REST Resource: accounts

Ressource: Konto

Die Account-Mitteilung bezieht sich auf das Konto eines Händlers in Shopping-Anzeigen. Es ist die primäre Entität für die Verwaltung von Produktdaten, Einstellungen und Interaktionen mit den Diensten von Google und externen Anbietern.

Konten können als eigenständige Entitäten oder als Teil einer Mehrfachkundenkontostruktur (Multi-Client Account, MCA) verwendet werden. Bei einer Mehrfachkundenkonto-Einrichtung werden über das übergeordnete Konto mehrere Unterkonten verwaltet.

Beim Erstellen eines Kontos müssen Sie Attribute wie den Kontonamen, die Zeitzone und die Spracheinstellungen konfigurieren.

Die Account-Nachricht ist die übergeordnete Entität für viele andere Ressourcen, z. B. AccountRelationship, Homepage und BusinessInfo.

JSON-Darstellung 
{
  "name": string,
  "accountId": string,
  "accountName": string,
  "adultContent": boolean,
  "testAccount": boolean,
  "timeZone": {
    object (TimeZone)
  },
  "languageCode": string
}
Felder
name

string

Kennung. Der Ressourcenname des Kontos. Format: accounts/{account}
accountId

string (int64 format)

Nur Ausgabe. Die ID des Kontos.
accountName

string

Erforderlich. Ein für Menschen lesbarer Name des Kontos. Weitere Informationen finden Sie unter Shopname und Name des Unternehmens.
adultContent

boolean

Gibt an, ob dieses Konto Inhalte nur für Erwachsene enthält.
testAccount

boolean

Nur Ausgabe. Gibt an, ob es sich um ein Testkonto handelt.
timeZone

object (TimeZone)

Erforderlich. Die Zeitzone des Kontos

Beim Schreiben wird über timeZone sowohl reporting_time_zone als auch display_time_zone festgelegt.

Bei Lesezugriffen gibt timeZone immer den display_time_zone zurück. Wenn display_time_zone für Ihr Konto nicht vorhanden ist, ist timeZone leer.
languageCode

string

Erforderlich. Der BCP-47-Sprachcode des Kontos, z. B. en-US oder sr-Latn.

TimeZone

Stellt eine Zeitzone aus der IANA-Zeitzonendatenbank dar.

JSON-Darstellung 
{
  "id": string,
  "version": string
}
Felder
id

string

Zeitzone aus der IANA-Zeitzonendatenbank. Beispiel: „America/New_York“.
version

string

Optional. Versionsnummer der IANA-Zeitzonendatenbank. Beispiel: „2019a“.

Methoden

createAndConfigure

 Es wird ein eigenständiges Merchant Center-Konto mit zusätzlicher Konfiguration erstellt.

delete

 Das angegebene Konto wird unabhängig von seinem Typ gelöscht: eigenständiges Konto, Mehrfachkundenkonto oder Unterkonto.

get

 Ruft ein Konto aus Ihrem Merchant Center-Konto ab.

list

 Hier werden Konten aufgelistet, auf die der aufrufende Nutzer zugreifen kann und die den Einschränkungen der Anfrage entsprechen, z. B. Seitengröße oder Filter.

listSubaccounts

 Listet alle Unterkonten für ein bestimmtes Mehrfachkundenkonto auf.

patch

 Aktualisiert ein Konto unabhängig von seinem Typ: eigenständiges Konto, Mehrfachkundenkonto oder Unterkonto.