Package google.shopping.merchant.accounts.v1beta

Index

AccountIssueService

Dienst zur Unterstützung der AccountIssueService API.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Listet alle Kontoprobleme eines Merchant Center-Kontos auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AccountsService

Dienst zur Unterstützung der Accounts API.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Erstellt ein eigenständiges Merchant Center-Konto mit zusätzlichen Konfigurationen. Fügt den Nutzer, der die Anfrage stellt, als Administrator für das neue Konto hinzu.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Löscht das angegebene Konto unabhängig von seinem Typ: eigenständiges Konto, Mehrfachkundenkonto oder Unterkonto. Durch das Löschen eines Mehrfachkundenkontos werden alle zugehörigen Unterkonten gelöscht. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Ruft ein Konto aus Ihrem Merchant Center-Konto ab. Nach dem Einfügen, Aktualisieren oder Löschen eines Kontos kann es einige Minuten dauern, bis die Änderungen wirksam werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Listet Konten auf, auf die der aufrufende Nutzer zugreifen kann und die den Einschränkungen der Anfrage wie Seitengröße oder Filter entsprechen. Dabei werden nicht nur die Unterkonten eines MCA aufgelistet, sondern alle Konten, auf die der aufrufende Nutzer Zugriff hat, einschließlich anderer MCAs, verknüpfter Konten, eigenständiger Konten usw.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Hiermit werden alle Unterkonten für ein bestimmtes Mehrfachkundenkonto aufgelistet. Dies ist ein praktischer Wrapper für die leistungsstärkere Methode ListAccounts. Diese Methode liefert dieselben Ergebnisse wie der Aufruf von ListsAccounts mit dem folgenden Filter: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aktualisiert ein Konto unabhängig von seinem Typ: eigenständiges Konto, Mehrfachkundenkonto oder Unterkonto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BusinessIdentityService

Dienst zur Unterstützung der Business Identity API

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Ruft die geschäftliche Identität eines Kontos ab

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Aktualisiert die Unternehmensidentität eines Kontos. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BusinessInfoService

Dienst zur Unterstützung der Business Info API.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Ruft die Unternehmensinformationen eines Kontos ab

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Aktualisiert die Unternehmensinformationen eines Kontos. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

EmailPreferencesService

Dienst zur Unterstützung der EmailPreferences API.

Dieser Dienst erlaubt nur das Abrufen und Aktualisieren der E-Mail-Einstellungen des authentifizierten Nutzers.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Gibt die E-Mail-Einstellungen für den Nutzer eines Merchant Center-Kontos zurück.

Verwenden Sie den Alias name=accounts/*/users/me/emailPreferences, um Einstellungen für den authentifizierten Nutzer zu erhalten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Aktualisiert die E-Mail-Einstellungen für den Nutzer eines Merchant Center-Kontos. Nutzer von Mehrfachkundenkonten sollten das MCA-Konto und nicht ein Unterkonto des Mehrfachkundenkontos angeben.

Einstellungen, die nicht explizit in der Aktualisierungsmaske ausgewählt wurden, werden nicht aktualisiert.

Für Updates kann kein Wert für den Aktivierungsstatus UNCONFIRMED angegeben werden.

Verwenden Sie den Alias name=accounts/*/users/me/emailPreferences, um die Einstellungen für den authentifizierten Nutzer zu aktualisieren.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

HomepageService

Dienst zur Unterstützung einer API für die Startseite eines Geschäfts

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Beansprucht die Startseite eines Geschäfts. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Wenn die Startseite bereits beansprucht wurde, wird die Bestätigung noch einmal überprüft (es sei denn, der Händler ist von der Beanspruchung ausgenommen, was ebenfalls von der Überprüfung ausgenommen ist) und eine erfolgreiche Antwort wird zurückgegeben. Wenn die Inhaberschaft nicht mehr bestätigt werden kann, wird ein Fehler zurückgegeben, der Anspruch wird jedoch nicht gelöscht. Im Falle eines Fehlers wird eine kanonische Fehlermeldung zurückgegeben: * PERMISSION_DENIED: Nutzer hat nicht die erforderlichen Berechtigungen für dieses MC-Konto; * FAILED_PRECONDITION: – Das Konto ist kein Merchant Center-Konto. - Das Merchant Center-Konto hat keine Startseite. – Beanspruchen fehlgeschlagen. In diesem Fall enthält die Fehlermeldung weitere Details.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Ruft die Startseite eines Geschäfts ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Hebt den Anspruch auf die Startseite eines Geschäfts auf. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Aktualisiert die Startseite eines Geschäfts. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

OnlineReturnPolicyService

Dieser Dienst erleichtert die Konfiguration der Rückgabebedingungen für Kaufreue eines Händlers, einschließlich Rückgabebedingungen für Anzeigen und Produkteinträge

Programmen. Diese API definiert das folgende Ressourcenmodell:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Ruft vorhandene Rückgabebedingungen ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Listet alle vorhandenen Rückgabebedingungen auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ProgramsService

Dienst für das Programmmanagement.

Programme bieten einen Mechanismus zum Hinzufügen von Funktionen zu Händlerkonten. Ein typisches Beispiel dafür ist das Programm Produkteinträge, mit dem Produkte aus dem Shop eines Händlers kostenlos auf Google präsentiert werden können.

Dieser Dienst bietet Methoden zum Abrufen der Teilnahme eines Händlers an allen verfügbaren Programmen sowie Methoden zum expliziten Aktivieren oder Deaktivieren der Teilnahme an jedem Programm.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Deaktivierung der Teilnahme am angegebenen Programm für das Konto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Für das Konto die Teilnahme am angegebenen Programm aktivieren. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Ruft das angegebene Programm für das Konto ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Ruft alle Programme für das Konto ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

RegionsService

Verwaltet die Konfiguration der Regionen.

Diese API definiert das folgende Ressourcenmodell:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Erstellt eine Regionsdefinition in Ihrem Merchant Center-Konto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Löscht eine Regionsdefinition aus Ihrem Merchant Center-Konto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Ruft eine in Ihrem Merchant Center-Konto definierte Region ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Listet die Regionen in Ihrem Merchant Center-Konto auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Aktualisiert eine Regionsdefinition in Ihrem Merchant Center-Konto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ShippingSettingsService

Dienst zum Abrufen von Informationen zu den Versandeinstellungen für Methodenaufrufe pro Merchant API-Methode.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Informationen zu Versandeinstellungen abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Die Versandeinstellung eines Händlers durch die Einstellung „Versand anfordern“ ersetzen. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

TermsOfServiceAgreementStateService

Dienst zur Unterstützung der TermsOfServiceAgreementState API.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Gibt den Status einer Vereinbarung über Nutzungsbedingungen zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Ruft den Status der Vereinbarung für die Nutzungsbedingungen der Anwendung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

TermsOfServiceService

Dienst zur Unterstützung der TermsOfService API.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Akzeptiert einen TermsOfService. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Ruft die TermsOfService ab, die der bereitgestellten Version zugeordnet ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Ruft die neueste Version von TermsOfService für einen bestimmten kind und region_code ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UserService

Dienst zur Unterstützung der Nutzer-API.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Erstellt einen Nutzer für ein Merchant Center-Konto. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Löscht einen Nutzer eines Merchant Center-Kontos. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetUser

rpc GetUser(GetUserRequest) returns (User)

Ruft einen Nutzer des Merchant Center-Kontos ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Listet alle Nutzer eines Merchant Center-Kontos auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Aktualisiert einen Nutzer eines Merchant Center-Kontos. Für die Ausführung dieser Methode ist Administratorzugriff erforderlich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AcceptTermsOfServiceRequest

Anfragenachricht für die Methode AcceptTermsOfService.

Felder
name

string

Erforderlich. Der Ressourcenname der Version der Nutzungsbedingungen. Format: termsOfService/{version}

account

string

Erforderlich. Das Konto, für das die Nutzungsbedingungen akzeptiert werden sollen.

region_code

string

Erforderlich. Vom CLDR definierter Regionscode. Dies ist entweder ein Land, wenn die Nutzungsbedingungen speziell für dieses Land gelten, oder 001, wenn sie weltweit gelten.

Akzeptiert

Beschreibt die akzeptierten Nutzungsbedingungen.

Felder
terms_of_service

string

Die akzeptierten termsOfService.

accepted_by

string

Das Konto, über das die Zustimmung aufgezeichnet wurde. Dies kann das Konto selbst oder, im Fall von Unterkonten, das MCA-Konto sein.

valid_until

Date

Wenn festgelegt, wird darin angegeben, dass die akzeptierten TermsOfService nur bis zum Ende dieses Datums (in UTC) gültig sind. Bis dahin muss eine neue akzeptiert werden. Die Informationen zu den erforderlichen TermsOfService finden Sie in der Meldung Required (Erforderlich).

AccessRight

Das Zugriffsrecht.

Enums
ACCESS_RIGHT_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
STANDARD Standardzugriffsrechte.
ADMIN Administratorzugriffsrechte.
PERFORMANCE_REPORTING Nutzer mit diesem Recht haben Zugriff auf Leistungsdaten und Statistiken.

Konto

Ein Konto.

Felder
name

string

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

account_id

int64

Nur Ausgabe. Die ID des Kontos.

account_name

string

Erforderlich. Ein visuell lesbarer Name des Kontos. Weitere Informationen finden Sie unter Name des Geschäfts und Name des Unternehmens.

adult_content

bool

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

test_account

bool

Nur Ausgabe. Ob es sich um ein Testkonto handelt

time_zone

TimeZone

Erforderlich. Die Zeitzone des Kontos

Bei Schreibvorgängen legt time_zone sowohl den reporting_time_zone als auch den display_time_zone fest.

Bei Lesevorgängen gibt time_zone immer den display_time_zone zurück. Wenn display_time_zone in Ihrem Konto nicht vorhanden ist, ist time_zone leer.

language_code

string

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

AccountIssue

Ein AccountIssue.

Felder
name

string

Kennung. Der Ressourcenname des Kontoproblems. Format: accounts/{account}/issues/{id}

title

string

Der lokalisierte Titel des Problems.

severity

Severity

Der allgemeine Schweregrad des Problems.

impacted_destinations[]

ImpactedDestination

Die Auswirkungen dieses Problems auf verschiedene Ziele.

detail

string

Weitere lokalisierte Details zum Problem.

documentation_uri

string

Link zur Merchant Center-Hilfe mit weiteren Informationen zum Problem und zu dessen Behebung.

ImpactedDestination

Die Auswirkungen des Problems auf ein Ziel.

Felder
impacts[]

Impact

Die (negativen) Auswirkungen für verschiedene Regionen auf das jeweilige Ziel.

reporting_context

ReportingContextEnum

Der betroffene Berichtskontext

Auswirkungen

Die Auswirkungen des Problems auf eine Region.

Felder
region_code

string

Der CLDR-Regionscode, in dem das Problem auftritt.

severity

Severity

Der Schweregrad des Problems am Ziel und in der Region.

Schweregrad

Alle möglichen Schweregrade des Problems.

Enums
SEVERITY_UNSPECIFIED Der Schweregrad ist unbekannt.
CRITICAL Das Problem führt dazu, dass Angebote nicht ausgeliefert werden.
ERROR Das Problem kann sich (in Zukunft) auf Angebote auswirken oder ein Hinweis auf Probleme mit Angeboten sein.
SUGGESTION Das Problem ist ein Verbesserungsvorschlag.

Adresse

Die Versandadresse des Lagers.

Felder
street_address

string

Teil der Adresse auf Straßenebene. Beispiel: 111w 31st Street.

city

string

Erforderlich. Stadt, Gemeinde oder Gemeinde Kann auch Ortsteile oder Unterortsteile umfassen, z. B. Stadtteile oder Vororte.

administrative_area

string

Erforderlich. Oberste Verwaltungseinheit des Landes. Beispiel: ein Bundesstaat wie Kalifornien („CA“) oder eine Provinz wie Quebec („QC“).

postal_code

string

Erforderlich. Postleitzahl (z. B. „94043“).

region_code

string

Erforderlich. CLDR-Ländercode (z. B. „US“).

BusinessDayConfig

Werktage im Lager.

Felder
business_days[]

Weekday

Erforderlich. Reguläre Werktage. Darf nicht leer sein.

Wochentag

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Erhebung von Daten zur Identität eines Unternehmens

Felder
name

string

Kennung. Der Ressourcenname der Unternehmensidentität. Format: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

Optional. Gibt an, ob ein Unternehmen von Schwarzen Inhabern geführt wird. Dieses optionale Feld ist nur für Händler verfügbar, für die das Land des Unternehmens auf US festgelegt ist. Außerdem gilt sie nicht für Marktplätze oder Marktplatzverkäufer.

women_owned

IdentityAttribute

Optional. Gibt an, ob das Unternehmen sich als von einer Frau geführt hat. Dieses optionale Feld ist nur für Händler verfügbar, für die das Land des Unternehmens auf US festgelegt ist. Außerdem gilt sie nicht für Marktplätze oder Marktplatzverkäufer.

veteran_owned

IdentityAttribute

Optional. Gibt an, ob das Unternehmen sich als „von Armeeveteran(en) geführtes Unternehmen“ ausgibt. Dieses optionale Feld ist nur für Händler verfügbar, für die das Land des Unternehmens auf US festgelegt ist. Außerdem gilt sie nicht für Marktplätze oder Marktplatzverkäufer.

latino_owned

IdentityAttribute

Optional. Gibt an, ob das Unternehmen sich als Unternehmen gibt, das von lateinamerikanischen Unternehmen geführt wird. Dieses optionale Feld ist nur für Händler verfügbar, für die das Land des Unternehmens auf US festgelegt ist. Außerdem gilt sie nicht für Marktplätze oder Marktplatzverkäufer.

small_business

IdentityAttribute

Optional. Gibt an, ob das Unternehmen sich als Kleinunternehmen ausweist. Dieses optionale Feld ist nur für Händler verfügbar, für die das Land des Unternehmens auf US festgelegt ist. Sie gilt auch nicht für Marktplätze.

IdentityAttribute

Alle Informationen im Zusammenhang mit einem Attribut zur Identität.

Felder
identity_declaration

IdentityDeclaration

Erforderlich. Die Identitätsdeklaration für dieses Attribut.

IdentityDeclaration

Alle möglichen Einstellungen zur Erklärung einer Identität.

Enums
IDENTITY_DECLARATION_UNSPECIFIED Standardwert, der angibt, dass keine Auswahl getroffen wurde.
SELF_IDENTIFIES_AS Gibt an, dass das Konto mit dem Attribut identifiziert werden kann.
DOES_NOT_SELF_IDENTIFY_AS Gibt an, dass das Konto nicht mit dem Attribut identifiziert werden kann.

PromotionsConsent

Alle möglichen Einstellungen für Angebote, die sich auf die Identität des Unternehmens beziehen

Enums

BusinessInfo

Sammlung von Informationen zu einem Unternehmen.

Felder
name

string

Kennung. Der Ressourcenname der Unternehmensinformationen. Format: accounts/{account}/businessInfo

address

PostalAddress

Optional. Die Adresse des Unternehmens.

phone

PhoneNumber

Nur Ausgabe. Die Telefonnummer des Unternehmens.

phone_verification_state

PhoneVerificationState

Nur Ausgabe. Der Status der telefonischen Bestätigung des Unternehmens.

customer_service

CustomerService

Optional. Der Kundenservice des Unternehmens.

korean_business_registration_number

string

Optional. Zehnstellige koreanische Gewerbeanmeldungsnummer, getrennt durch Bindestriche im Format XXX-XX-XXXXX.

CarrierRate

Eine Liste der vom Transportunternehmen berechneten Preise, auf die unter main_table oder single_value verwiesen werden kann.

Felder
name

string

Erforderlich. Name des vom Transportunternehmen berechneten Preises. Muss pro Preisgruppe eindeutig sein.

carrier

string

Erforderlich. Versandservice wie "UPS" oder "Fedex".

carrier_service

string

Erforderlich. Versandservice wie "ground" oder "2 days".

origin_postal_code

string

Erforderlich. Herkunftsort des Versands für diesen vom Transportunternehmen berechneten Preis.

percentage_adjustment

string

Optional. Multiplikativer Versandpreismodifikator als Zahl im Dezimalformat. Kann negativ sein. Beispiel: "5.4" erhöht die Rate um 5,4%, "-3" verringert sie um 3%.

flat_adjustment

Price

Optional. Modifikator für zusätzliche Versandkostenpauschalen. Kann negativ sein. Beispiel: { "amount_micros": 1, "currency_code" : "USD" } addiert 1 € zum Preis auf, { "amount_micros": -3, "currency_code" : "USD" } entfernt 3 € vom Preis.

ClaimHomepageRequest

Anfragenachricht für die Methode ClaimHomepage.

Felder
name

string

Erforderlich. Der Name der Startseite, auf die Anspruch erhoben werden soll. Format: accounts/{account}/homepage

CreateAndConfigureAccountRequest

Anfragenachricht für die Methode CreateAndConfigureAccount.

Felder
account

Account

Erforderlich. Das Konto, das erstellt werden soll.

users[]

CreateUserRequest

Optional. Nutzer, die dem Konto hinzugefügt werden sollen.

service[]

AddAccountService

Erforderlich. Im Rahmen der Erstellung wird ein Kontoservice zwischen dem zu erstellenden Konto und dem Anbieterkonto initialisiert. Es muss mindestens eine solche Dienstleistung bereitgestellt werden. Derzeit wird nur account_aggregation unterstützt. Das bedeutet, dass das neu erstellte Konto ein Unterkonto des Anbieters ist, der im account_aggregation-Dienst definiert ist.

accept_terms_of_service

AcceptTermsOfService

Optional. Diese Nutzungsbedingungen müssen unmittelbar nach der Kontoerstellung akzeptiert werden.

AcceptTermsOfService

Verweis auf eine Ressource zu den Nutzungsbedingungen.

Felder
name

string

Erforderlich. Der Ressourcenname der Version der Nutzungsbedingungen.

region_code

string

Erforderlich. Vom CLDR definierter Regionscode. Dies ist entweder ein Land, wenn die Nutzungsbedingungen speziell für dieses Land gelten, oder 001, wenn sie weltweit gelten.

AddAccountService

Zusätzliche Anweisungen zum Hinzufügen von Kontodiensten während der Erstellung des Kontos.

Felder
Union-Feld service_type. Derzeit wird nur der übergeordnete Kontotyp Mehrfachkundenkonto unterstützt. Für service_type ist nur einer der folgenden Werte zulässig:
account_aggregation

Empty

Der Anbieter ist ein Aggregator für das Konto.

provider

string

Optional. Der Anbieter der Dienstleistung. Format: accounts/{account}

CreateRegionRequest

Anfragenachricht für die Methode CreateRegion.

Felder
parent

string

Erforderlich. Das Konto, für das eine Region erstellt werden soll. Format: accounts/{account}

region_id

string

Erforderlich. Die Kennung für die Region, die für alle Regionen desselben Kontos eindeutig ist.

region

Region

Erforderlich. Die zu erstellende Region.

CreateUserRequest

Anfragenachricht für die Methode CreateUser.

Felder
parent

string

Erforderlich. Der Ressourcenname des Kontos, für das ein Nutzer erstellt wird. Format: accounts/{account}

user_id

string

Erforderlich. Die E-Mail-Adresse des Nutzers, z. B. john.doe@gmail.com.

user

User

Erforderlich. Der zu erstellende Nutzer.

CustomerService

Informationen zum Kundenservice.

Felder
uri

string

Optional. Die URI, unter der sich der Kundenservice befindet.

email

string

Optional. Die E-Mail-Adresse, unter der der Kundenservice erreichbar ist.

phone

PhoneNumber

Optional. Die Telefonnummer, unter der der Kundenservice erreichbar ist.

CutoffTime

Definition des Annahmeschlusses für Werktage.

Felder
hour

int32

Erforderlich. Stunde des Annahmeschlusses, bis zu dem eine Bestellung aufgegeben werden muss, um am selben Tag verarbeitet zu werden.

minute

int32

Erforderlich. Minute des Annahmeschlusses, bis zu dem eine Bestellung aufgegeben werden muss, um am selben Tag verarbeitet zu werden.

time_zone

string

Erforderlich. Zeitzonenkennung Zum Beispiel „Europa/Zürich“.

DeleteAccountRequest

Anfragenachricht für die Methode DeleteAccount.

Felder
name

string

Erforderlich. Der Name des zu löschenden Kontos. Format: accounts/{account}

DeleteRegionRequest

Anfragenachricht für die Methode DeleteRegion.

Felder
name

string

Erforderlich. Der Name der zu löschenden Region. Format: accounts/{account}/regions/{region}

DeleteUserRequest

Anfragenachricht für die Methode DeleteUser.

Felder
name

string

Erforderlich. Der Name des zu löschenden Nutzers. Format: accounts/{account}/users/{email}

Es ist auch möglich, den dem Anrufer entsprechenden Nutzer zu löschen, indem du me anstelle einer E-Mail-Adresse wie in accounts/{account}/users/me verwendest.

DeliveryTime

Zeit, die für verschiedene Aspekte von der Bestellung bis zur Lieferung des Produkts aufgewendet wird.

Felder
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Optional. Gibt an, dass die Lieferdauer pro Lager (Herkunftsort des Versands) basierend auf den Einstellungen des ausgewählten Transportunternehmens berechnet werden soll. Wenn dies festgelegt ist, darf kein anderes Feld mit Bezug zur Laufzeit in [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] festgelegt werden.

min_transit_days

int32

Mindestanzahl von Arbeitstagen, die für den Versand aufgewendet werden. 0 bedeutet Lieferung am selben Tag, 1 eine Lieferung am nächsten Tag. Es muss entweder min_transit_days, max_transit_days oder transit_time_table festgelegt werden, aber nicht beides.

max_transit_days

int32

Maximale Anzahl von Werktagen, die auf dem Transportweg aufgewendet werden. 0 bedeutet Lieferung am selben Tag, 1 eine Lieferung am nächsten Tag. Muss größer oder gleich min_transit_days sein.

cutoff_time

CutoffTime

Definition des Annahmeschlusses für Werktage. Wenn nicht konfiguriert, wird der Annahmeschluss standardmäßig auf 8:00 Uhr PST (UTC -8) festgelegt.

min_handling_days

int32

Mindestanzahl von Arbeitstagen, die bis zum Versand einer Bestellung benötigt werden. 0 bedeutet, dass die Lieferung am selben Tag versendet wird, 1 bedeutet, dass der Versand am nächsten Tag erfolgt.

max_handling_days

int32

Maximale Anzahl von Werktagen, die bis zum Versand einer Bestellung benötigt werden. 0 bedeutet, dass die Lieferung am selben Tag versendet wird, 1 bedeutet, dass der Versand am nächsten Tag erfolgt. Muss größer oder gleich min_handling_days sein.

transit_time_table

TransitTable

Lieferzeittabelle, Anzahl der Werktage, die auf dem Transportweg verbracht wurden, basierend auf Zeilen- und Spaltendimensionen. Es kann entweder min_transit_days, max_transit_days oder transit_time_table festgelegt werden, aber nicht beides.

handling_business_day_config

BusinessDayConfig

Die Werktage, an denen Bestellungen bearbeitet werden können. Wenn nicht angegeben, wird von Montag bis Freitag Werktagen ausgegangen.

transit_business_day_config

BusinessDayConfig

Die Werktage, an denen Bestellungen auf dem Transportweg sein können. Wenn nicht angegeben, wird von Montag bis Freitag Werktagen ausgegangen.

DisableProgramRequest

Anfragenachricht für die Methode "DisableProgram".

Felder
name

string

Erforderlich. Der Name des Programms, für das die Teilnahme des jeweiligen Kontos deaktiviert werden soll. Format: accounts/{account}/programs/{program}

Entfernung

Maximaler Lieferradius. Dies ist nur für die Versandart „Lokale Lieferung“ erforderlich.

Felder
value

int64

Ganzzahlwert der Entfernung.

unit

Unit

Die Einheit kann sich je nach Land unterscheiden. Sie ist so parametrisiert, dass Meilen und Kilometer enthalten sind.

Einheit

Die Einheit kann sich je nach Land unterscheiden. Sie ist so parametrisiert, dass Meilen und Kilometer enthalten sind.

Enums
UNIT_UNSPECIFIED Einheit nicht angegeben
MILES Einheit in Meilen
KILOMETERS Einheit in Kilometern

EmailPreferences

Die Kategorien der Benachrichtigungen, die der Nutzer aktiviert oder deaktiviert hat. Die E-Mail-Einstellungen enthalten keine verbindlichen Mitteilungen, da Nutzer diese nicht deaktivieren können.

Felder
name

string

Kennung. Der Name der E-Mail-Einstellungen. Der Endpunkt wird nur für den authentifizierten Nutzer unterstützt.

news_and_tips

OptInState

Optional. Updates zu neuen Funktionen, Tipps und Best Practices.

OptInState

Aktivieren Sie den Status der E-Mail-Einstellungen.

Enums
OPT_IN_STATE_UNSPECIFIED Der Aktivierungsstatus ist nicht angegeben.
OPTED_OUT Der Nutzer hat den Erhalt solcher E-Mails deaktiviert.
OPTED_IN Der Nutzer hat dem Erhalt dieser Art von E-Mail zugestimmt.
UNCONFIRMED Der Nutzer hat dem Erhalt dieser Art von E-Mail zugestimmt und die Bestätigungs-E-Mail wurde gesendet. Der Nutzer hat die Zustimmung jedoch noch nicht bestätigt (gilt nur für bestimmte Länder).

EnableProgramRequest

Anfragenachricht für die Methode EnableProgram.

Felder
name

string

Erforderlich. Der Name des Programms, an dem die Teilnahme für das jeweilige Konto aktiviert werden soll. Format: accounts/{account}/programs/{program}

GetAccountRequest

Anfragenachricht für die Methode GetAccount.

Felder
name

string

Erforderlich. Der Name des abzurufenden Kontos. Format: accounts/{account}

GetBusinessIdentityRequest

Anfragenachricht für die Methode GetBusinessIdentity.

Felder
name

string

Erforderlich. Der Ressourcenname der Unternehmensidentität. Format: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Anfragenachricht für die Methode GetBusinessInfo.

Felder
name

string

Erforderlich. Der Ressourcenname der Unternehmensinformationen. Format: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Anfragenachricht für die Methode "GetEmailPreferences".

Felder
name

string

Erforderlich. Der Name der EmailPreferences-Ressource. Format: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Anfragenachricht für die Methode GetHomepage.

Felder
name

string

Erforderlich. Der Name der abzurufenden Startseite. Format: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Anfragenachricht für die Methode GetOnlineReturnPolicy.

Felder
name

string

Erforderlich. Der Name der abzurufenden Rückgabebedingungen. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Anfragenachricht für die Methode "GetProgram".

Felder
name

string

Erforderlich. Der Name des abzurufenden Programms. Format: accounts/{account}/programs/{program}

GetRegionRequest

Anfragenachricht für die Methode GetRegion.

Felder
name

string

Erforderlich. Der Name der Region, die abgerufen werden soll. Format: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Anfragenachricht für die Methode GetShippingSetting.

Felder
name

string

Erforderlich. Der Name der abzurufenden Versandeinstellung. Format: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Anfragenachricht für die Methode GetTermsOfServiceAgreementState.

Felder
name

string

Erforderlich. Der Ressourcenname der Version der Nutzungsbedingungen. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Das Format der Kennung ist: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

Anfragenachricht für die Methode GetTermsOfService.

Felder
name

string

Erforderlich. Der Ressourcenname der Version der Nutzungsbedingungen. Format: termsOfService/{version}

GetUserRequest

Anfragenachricht für die Methode GetUser.

Felder
name

string

Erforderlich. Der Name des abzurufenden Nutzers. Format: accounts/{account}/users/{email}

Es ist auch möglich, den zum Anrufer gehörenden Nutzer abzurufen, indem du me anstelle einer E-Mail-Adresse verwendest, wie in accounts/{account}/users/me.

Header

Eine nicht leere Liste mit Zeilen- oder Spaltenüberschriften für eine Tabelle. Genau eines der folgenden Werte muss festgelegt werden: prices, weights, num_items, postal_code_group_names oder location.

Felder
prices[]

Price

Erforderlich. Eine Liste mit Obergrenzen für den Bestellwert. Der Wert des letzten Preises kann unendlich sein, indem der Wert für „price_quantity_micros = -1“ festgelegt wird. [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] steht beispielsweise für die Header „<= $10“, „<= 500“ und "> 500 €“. Alle Preise innerhalb einer Dienstleistung müssen in derselben Währung angegeben sein. Das Feld darf nicht leer sein. Muss positiv sein, außer -1. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

weights[]

Weight

Erforderlich. Eine Liste der inklusiven Obergrenzen für das Bestellgewicht. Der Wert der letzten Gewichtung kann unendlich sein, indem „price_amount_micros“ = -1 festgelegt wird. Beispiel: [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] repräsentiert die Überschriften „<= 10 kg“, „<= 50 kg“ und "> 50 kg". Alle Gewichtungen innerhalb einer Dienstleistung müssen dieselbe Einheit haben. Das Feld darf nicht leer sein. Muss positiv sein, außer -1. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

number_of_items[]

string

Erforderlich. Eine Liste mit der Obergrenze der Elemente, die die Elemente enthalten. Der letzte Wert kann "infinity" sein. Beispielsweise steht ["10", "50", "infinity"] für die Überschriften „<= 10 Elemente“, „<= 50 Elemente“ und "> 50 Elemente". Das Feld darf nicht leer sein. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

postal_code_group_names[]

string

Erforderlich. Eine Liste von Postgruppennamen. Der letzte Wert kann "all other locations" sein. Beispiel: ["zone 1", "zone 2", "all other locations"]. Die angegebenen Postleitzahlengruppen müssen mit dem Lieferland des Dienstes übereinstimmen. Das Feld darf nicht leer sein. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

locations[]

LocationIdSet

Erforderlich. Eine Liste mit Standort-ID-Sätzen. Das Feld darf nicht leer sein. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

Startseite

Die Startseite eines Geschäfts

Felder
name

string

Kennung. Der Ressourcenname der Startseite des Geschäfts. Format: accounts/{account}/homepage

claimed

bool

Nur Ausgabe. Ob die Startseite beansprucht wird. Weitere Informationen finden Sie unter https://support.google.com/merchants/answer/176793.

uri

string

Erforderlich. Der URI (normalerweise eine URL) der Startseite des Geschäfts

InsertShippingSettingsRequest

Anfragenachricht für die Methode InsertShippingSetting.

Felder
parent

string

Erforderlich. Das Konto, in das dieses Produkt eingefügt wird. Format: accounts/{account}

shipping_setting

ShippingSettings

Erforderlich. Die neue Version des Kontos.

ListAccountIssuesRequest

Anfragenachricht für die Methode ListAccountIssues.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Sammlung von Problemen gehört. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Ausgaben. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Nutzer zurückgegeben. Der Höchstwert ist 100. Werte über 100 werden in 100 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListAccountIssues-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListAccountIssues bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

language_code

string

Optional. Die Probleme in der Antwort enthalten für Menschen lesbare Felder in der angegebenen Sprache. Das Format ist BCP-47, z. B. en-US oder sr-Latn. Wenn kein Wert angegeben ist, wird en-US verwendet.

time_zone

TimeZone

Optional. Die IANA-Zeitzone, die zur Lokalisierung von Zeiten in visuell lesbaren Feldern verwendet wird. Beispiel: „America/Los_Angeles“. Wenn nicht festgelegt, "America/Los_Angeles" verwendet werden.

ListAccountIssuesResponse

Antwortnachricht für die Methode ListAccountIssues.

Felder
account_issues[]

AccountIssue

Die Probleme mit dem angegebenen Konto.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListAccountsRequest

Anfragenachricht für die Methode ListAccounts.

Felder
page_size

int32

Optional. Die maximale Anzahl von Konten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Angabe gemacht wird, werden maximal 250 Konten zurückgegeben. Der Maximalwert beträgt 500. werden Werte über 500 in 500 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListAccounts-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListAccounts bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Optional. Gibt nur Konten zurück, die dem filter entsprechen. Weitere Informationen finden Sie in der Referenz zur Filtersyntax.

ListAccountsResponse

Antwortnachricht für die Methode ListAccounts.

Felder
accounts[]

Account

Die Konten, die mit ListAccountsRequest übereinstimmen.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListOnlineReturnPoliciesRequest

Anfragenachricht für die Methode ListOnlineReturnPolicies.

Felder
parent

string

Erforderlich. Das Händlerkonto, für das Rückgabebedingungen aufgelistet werden sollen. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von OnlineReturnPolicy-Ressourcen, die zurückgegeben werden sollen. Der Dienst gibt einen geringeren Wert als diesen Wert zurück, wenn die Anzahl der Rückgabebedingungen für den jeweiligen Händler unter dem Wert für pageSize liegt. Der Standardwert ist 10. Der Höchstwert ist 100. Wenn ein Wert angegeben wird, der über dem Maximum liegt, wird für pageSize standardmäßig das Maximum verwendet

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListOnlineReturnPolicies-Aufruf empfangen wurde. Geben Sie das Seitentoken an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListOnlineReturnPolicies bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Das Token, das in der Antwort auf die vorherige Anfrage als nextPageToken zurückgegeben wurde.

ListOnlineReturnPoliciesResponse

Antwortnachricht für die Methode ListOnlineReturnPolicies.

Felder
online_return_policies[]

OnlineReturnPolicy

Die abgerufenen Rückgabebedingungen.

next_page_token

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListProgramsRequest

Anfragenachricht für die Methode "ListPrograms"

Felder
parent

string

Erforderlich. Der Name des Kontos, für das alle Programme abgerufen werden sollen. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von Programmen, die in einer einzelnen Antwort zurückgegeben werden sollen. Wenn kein Wert (oder 0) angegeben ist, wird eine Standardgröße von 1.000 verwendet. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Fortsetzungs-Token, das von einem vorherigen ListPrograms-Aufruf empfangen wurde. Geben Sie dies an, um die nächste Seite abzurufen.

ListProgramsResponse

Antwortnachricht für die Methode ListPrograms.

Felder
programs[]

Program

Die Programme für das jeweilige Konto.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListRegionsRequest

Anfragenachricht für die Methode ListRegions.

Felder
parent

string

Erforderlich. Das Konto, für das Regionen aufgelistet werden sollen. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von Regionen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Regionen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListRegions-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListRegions bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListRegionsResponse

Antwortnachricht für die Methode ListRegions.

Felder
regions[]

Region

Die Regionen des angegebenen Händlers.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListSubAccountsRequest

Anfragenachricht für die Methode ListSubAccounts.

Felder
provider

string

Erforderlich. Das übergeordnete Konto. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von Konten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 250 Konten zurückgegeben. Der Maximalwert beträgt 500. werden Werte über 500 in 500 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListAccounts-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListAccounts bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListSubAccountsResponse

Antwortnachricht für die Methode ListSubAccounts.

Felder
accounts[]

Account

Die Konten, für die das übergeordnete Konto ein Aggregator ist.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListUsersRequest

Anfragenachricht für die Methode ListUsers.

Felder
parent

string

Erforderlich. Das übergeordnete Element, dem diese Nutzersammlung gehört. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von Nutzern, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Nutzer zurückgegeben. Der Höchstwert ist 100. Werte über 100 werden in 100 umgewandelt.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListUsers-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUsers bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListUsersResponse

Antwortnachricht für die Methode ListUsers.

Felder
users[]

User

Die Nutzer aus dem angegebenen Konto.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LocationIdSet

Eine Liste mit Standort-ID-Sätzen. Das Feld darf nicht leer sein. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

Felder
location_ids[]

string

Erforderlich. Eine nicht leere Liste mit Standort-IDs. Sie müssen alle denselben Standorttyp haben (z. B. Bundesland).

MinimumOrderValueTable

Tabelle mit den Mindestbestellwerten pro Geschäft für die Art der Abholung.

Felder
store_code_set_with_movs[]

StoreCodeSetWithMov

Erforderlich. Eine Liste mit Geschäftscodes mit demselben Mindestbestellwert (MOV). Mindestens zwei Sätze sind erforderlich und der letzte muss leer sein, was auf "MOV für alle anderen Speicher" hinweist. Jeder Geschäftscode darf in allen Gruppen nur einmal verwendet werden. Alle Preise innerhalb einer Dienstleistung müssen in derselben Währung angegeben sein.

StoreCodeSetWithMov

Eine Liste mit Geschäftscodes mit demselben Mindestbestellwert. Mindestens zwei Sätze sind erforderlich und der letzte muss leer sein, was auf "MOV für alle anderen Speicher" hinweist. Jeder Geschäftscode darf in allen Gruppen nur einmal verwendet werden. Alle Preise innerhalb einer Dienstleistung müssen in derselben Währung angegeben sein.

Felder
store_codes[]

string

Optional. Eine Liste eindeutiger Geschäftscodes oder leer für alle allgemeinen Geschäftscodes.

value

Price

Der Mindestbestellwert für die angegebenen Geschäfte.

OnlineReturnPolicy

Online-Rückgabebedingungen. Dieses Attribut wird derzeit verwendet, um Rückgabebedingungen für Anzeigen und Produkteinträge darzustellen.

Felder
name

string

Kennung. Der Name der OnlineReturnPolicy-Ressource. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Nur Ausgabe. Von Google generierte Rückgaberichtlinien-ID.

label

string

Dieses Feld enthält die eindeutige benutzerdefinierte Bezeichnung der Rückgabebedingungen. Bitte beachten Sie, dass dasselbe Label nicht in verschiedenen Rückgabebedingungen für dasselbe Land verwendet werden kann. Sofern für ein Produkt kein bestimmtes Labelattribut angegeben ist, werden Richtlinien automatisch als „Standard“ gekennzeichnet. Wenn Sie bestimmten Produktgruppen benutzerdefinierte Rückgabebedingungen zuweisen möchten, folgen Sie der Anleitung zum Label für die Rückgabebedingungen. Das Label kann bis zu 50 Zeichen enthalten.

countries[]

string

Die Absatzländer, in denen die Rückgabebedingungen gelten. Die Werte müssen ein gültiger ISO 3166-Code mit zwei Buchstaben sein.

policy

Policy

Die Rückgabebedingungen.

restocking_fee

RestockingFee

Die Rücknahmegebühr, die für alle Kategorien von Rückgabegründen gilt. Wird kein Wert festgelegt, wird dies als kostenlose Rücknahmegebühr behandelt.

return_methods[]

ReturnMethod

Die Rückgabemethoden, mit denen Kunden einen Artikel zurückgeben können. Dieser Wert muss angegeben werden, es sei denn, der Typ der Rückgabebedingungen ist „noReturns“.

item_conditions[]

ItemCondition

Die für Retouren akzeptierten Artikelbedingungen dürfen nicht leer sein, es sei denn, der Typ der Rückgabebedingungen ist „noReturns“.

return_shipping_fee

ReturnShippingFee

Die Rücksendegebühr. Sollte nur festgelegt werden, wenn Kunden das Rücksendelabel herunterladen und ausdrucken müssen.

return_policy_uri

string

Der URI für die Rückgabebedingungen. Damit kann Google eine Plausibilitätsprüfung für die Richtlinie durchführen. Es muss sich um eine gültige URL handeln.

accept_defective_only

bool

Dieses Feld gibt an, ob der Händler nur mangelhafte Produkte für Retouren akzeptiert. Dieses Feld ist erforderlich.

process_refund_days

int32

Das Feld gibt die Anzahl der Tage an, die Händler benötigen, um Erstattungen zu bearbeiten. Das Feld ist optional.

accept_exchange

bool

Dieses Feld gibt an, ob der Händler Kunden den Umtausch von Produkten gestattet. Dieses Feld ist erforderlich.

ItemCondition

Die verfügbaren Artikelbedingungen.

Enums
ITEM_CONDITION_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NEW Jetzt
USED Verwendet.

Richtlinie

Die verfügbaren Richtlinien.

Felder
type

Type

Richtlinientyp.

days

int64

Die Anzahl der Tage, die Artikel nach der Lieferung zurückgegeben werden können, wobei ein Tag als 24 Stunden nach dem Zeitstempel der Lieferung definiert ist. Erforderlich für Retouren in Höhe von NUMBER_OF_DAYS_AFTER_DELIVERY.

Typ

Arten von Rückgabebedingungen.

Enums
TYPE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NUMBER_OF_DAYS_AFTER_DELIVERY Die Anzahl der Tage, innerhalb der eine Rückgabe nach Lieferung gültig ist.
NO_RETURNS Keine Rückgabe.
LIFETIME_RETURNS Ihre Lebensdauer kehrt zurück.

RestockingFee

Die Rücknahmegebühr. Dabei kann es sich um eine Pauschale oder einen Mikroprozentsatz handeln.

Felder

Union-Feld type.

Für type ist nur einer der folgenden Werte zulässig:

fixed_fee

Price

Feste Rücknahmegebühr.

micro_percent

int32

Prozentsatz des Gesamtpreises in Mikroeinheiten. 15.000.000 bedeutet, dass 15% des Gesamtpreises in Rechnung gestellt werden.

ReturnMethod

Die verfügbaren Rückgabemethoden.

Enums
RETURN_METHOD_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
BY_MAIL Rücksendung per Post.
IN_STORE Rückgabe im Geschäft.
AT_A_KIOSK Rückgabe an einem Kiosk:

ReturnShippingFee

Die Rücksendegebühr. Dies kann eine feste Gebühr oder ein boolescher Wert sein, der angibt, dass der Kunde die tatsächlichen Versandkosten trägt.

Felder
type

Type

Art der Rücksendegebühr.

fixed_fee

Price

Feste Rücksendegebühr. Dieser Wert gilt nur, wenn der Typ FIXED ist. Wir betrachten die Rücksendegebühr als kostenlos, wenn der Typ FIXED ist und dieser Wert nicht festgelegt ist.

Typ

Rücksendegebührenarten.

Enums
TYPE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
FIXED Die Rücksendegebühr ist ein fester Wert.
CUSTOMER_PAYING_ACTUAL_FEE Kunden zahlen die tatsächliche Rücksendegebühr.

PhoneVerificationState

Status der telefonischen Bestätigung.

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
PHONE_VERIFICATION_STATE_VERIFIED Die Telefonnummer wurde bestätigt.
PHONE_VERIFICATION_STATE_UNVERIFIED Die Telefonnummer ist nicht bestätigt

Programm

Definiert die Teilnahme an einem bestimmten Programm für das angegebene Konto.

Programme bieten einen Mechanismus zum Hinzufügen von Funktionen zu Händlerkonten. Ein typisches Beispiel dafür ist das Programm Produkteinträge, mit dem Produkte aus dem Shop eines Händlers kostenlos auf Google präsentiert werden können.

Felder
name

string

Kennung. Der Ressourcenname des Programms. Format: accounts/{account}/programs/{program}

documentation_uri

string

Nur Ausgabe. Die URL einer Merchant Center-Hilfeseite, auf der das Programm beschrieben wird.

state

State

Nur Ausgabe. Der Teilnahmestatus des Kontos am Programm.

active_region_codes[]

string

Nur Ausgabe. Die Regionen, in denen das Konto aktiv am Programm teilnimmt. Als aktive Regionen gelten Regionen, in denen alle Programmanforderungen für die Regionen erfüllt sind.

Regionscodes werden durch den CLDR definiert. Dies ist entweder ein Land, in dem das Programm speziell für dieses Land gilt, oder 001, wenn das Programm weltweit gilt.

unmet_requirements[]

Requirement

Nur Ausgabe. Die Anforderungen, die das Konto noch nicht erfüllt hat und die sich auf die Teilnahme am Programm auswirken.

Anforderung

Definiert eine Anforderung für die Teilnahme am Programm.

Felder
title

string

Nur Ausgabe. Name der Anforderung.

documentation_uri

string

Nur Ausgabe. Die URL einer Hilfeseite, auf der die Anforderung beschrieben wird.

affected_region_codes[]

string

Nur Ausgabe. Die Regionen, die derzeit von dieser Anforderung betroffen sind, werden nicht erfüllt.

Regionscodes werden durch den CLDR definiert. Dies ist entweder ein Land, in dem das Programm speziell für dieses Land gilt, oder 001, wenn das Programm weltweit gilt.

Status

Mögliche Programmteilnahmestatus für das Konto.

Enums
STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NOT_ELIGIBLE Das Konto ist nicht zur Teilnahme am Programm berechtigt.
ELIGIBLE Das Konto ist zur Teilnahme am Programm berechtigt.
ENABLED Das Programm ist für das Konto aktiviert.

RateGroup

Gruppendefinitionen für Versandkosten. Nur das letzte Feld darf ein leeres applicable_shipping_labels enthalten, was „alles andere“ bedeutet. Die anderen applicable_shipping_labels dürfen sich nicht überschneiden.

Felder
applicable_shipping_labels[]

string

Erforderlich. Eine Liste von Versandlabels, mit denen die Produkte definiert werden, für die diese Preisgruppe gilt. Dies ist eine Disjunktion: Nur eines der Labels muss übereinstimmen, damit die Preisgruppe angewendet wird. Darf nur für die letzte Preisgruppe eines Dienstes leer sein.

subtables[]

Table

Optional. Eine Liste von untergeordneten Tabellen, auf die in main_table verwiesen wird. Kann nur festgelegt werden, wenn main_table festgelegt ist.

carrier_rates[]

CarrierRate

Optional. Eine Liste der vom Transportunternehmen berechneten Preise, auf die über main_table oder single_value verwiesen werden kann.

single_value

Value

Der Wert der Preisgruppe (z. B. Pauschalpreis 10 €). Kann nur festgelegt werden, wenn main_table und subtables nicht festgelegt sind.

main_table

Table

Eine Tabelle zur Definition der Preisgruppe, wenn single_value nicht ausdrucksstark genug ist. Kann nur festgelegt werden, wenn single_value nicht festgelegt ist.

name

string

Optional. Name der Preisgruppe. Wenn festgelegt, muss er innerhalb des Versandservice eindeutig sein.

Region

Stellt eine geografische Region dar, die Sie mit den Diensten RegionalInventory und ShippingSettings als Ziel verwenden können. Sie können Regionen als Sammlungen von Postleitzahlen definieren oder in einigen Ländern vordefinierte geografische Ziele verwenden. Weitere Informationen finden Sie unter Regionen einrichten .

Felder
name

string

Kennung. Der Ressourcenname der Region. Format: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

Optional. Eine Liste von Postleitzahlen, die das Gebiet definiert.

geotarget_area

GeoTargetArea

Optional. Eine Liste von geografischen Zielen, die das Gebiet definiert.

regional_inventory_eligible

BoolValue

Nur Ausgabe. Gibt an, ob die Region in der Konfiguration für regionales Inventar verwendet werden kann.

shipping_eligible

BoolValue

Nur Ausgabe. Gibt an, ob die Region in der Konfiguration der Versanddienste verwendet werden kann.

display_name

string

Optional. Der Anzeigename der Region.

GeoTargetArea

Eine Liste von geografischen Zielen, die das Gebiet definiert.

Felder
geotarget_criteria_ids[]

int64

Erforderlich. Eine nicht leere Liste mit Standort-IDs. Sie müssen alle denselben Standorttyp haben (z. B. Bundesland).

PostalCodeArea

Eine Liste von Postleitzahlen, die das Gebiet definiert. Hinweis: Auf alle mit Postleitzahlen definierten Regionen kann über die Ressource ShippingSettings.postalCodeGroups des Kontos zugegriffen werden.

Felder
region_code

string

Erforderlich. CLDR-Regionscode oder das Land, für das die Postleitzahlengruppe gilt.

postal_codes[]

PostalCodeRange

Erforderlich. Einen Postleitzahlenbereich.

PostalCodeRange

Ein Postleitzahlenbereich, der die Region definiert.

Felder
begin

string

Erforderlich. Eine Postleitzahl oder ein Muster im Formatpräfix*, das die einschließende Untergrenze des Bereichs angibt, mit dem das Gebiet definiert wird. Beispielwerte: 94108, 9410*, 9*.

end

string

Optional. Eine Postleitzahl oder ein Muster im Format prefix*, das die einschließende Obergrenze des Bereichs angibt, mit dem das Gebiet definiert wird. Sie muss dieselbe Länge wie "postCodeRangeBegin" haben: Wenn "postCodeRangeBegin" eine Postleitzahl ist, muss "postCodeRangeEnd" auch eine Postleitzahl sein. Wenn postalCodeRangeBegin ein Muster ist, muss „postCodeRangeEnd“ ein Muster mit derselben Präfixlänge sein. Optional: Wenn nichts festgelegt ist, wird das Gebiet als alle Postleitzahlen definiert, die mit „postCodeRangeBegin“ übereinstimmen.

Erforderlich

Beschreibt die Nutzungsbedingungen, die akzeptiert werden müssen.

Felder
terms_of_service

string

Die termsOfService (Nutzungsbedingungen), die akzeptiert werden müssen.

tos_file_uri

string

Vollständige URL zur Datei mit den Nutzungsbedingungen. Dieses Feld ist mit TermsOfService.file_uri identisch. Es wurde hier nur der Einfachheit halber hinzugefügt.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Anfragenachricht für die Methode RetrieveForApplicationTermsOfServiceAgreementState.

Felder
parent

string

Erforderlich. Das Konto, für das das Format „TermsOfServiceAgreementState“ abgerufen werden soll: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Anfragenachricht für die Methode RetrieveLatestTermsOfService.

Felder
region_code

string

Vom CLDR definierter Regionscode. Dies ist entweder ein Land, wenn die Nutzungsbedingungen speziell für dieses Land gelten, oder 001, wenn sie weltweit gelten.

kind

TermsOfServiceKind

Die Art, für die diese Version der Nutzungsbedingungen gilt.

Zeile

Fügen Sie eine Liste von Zellen hinzu.

Felder
cells[]

Value

Erforderlich. Die Liste der Zellen, aus denen die Zeile besteht. Muss dieselbe Länge wie columnHeaders für zweidimensionale Tabellen und 1 Länge für eindimensionale Tabellen haben.

Dienst

Versandservice.

Felder
delivery_countries[]

string

Erforderlich. Der CLDR-Gebietscode der Länder, für die der Dienst gilt.

rate_groups[]

RateGroup

Optional. Gruppendefinitionen für Versandkosten. Nur das letzte Feld darf ein leeres applicable_shipping_labels enthalten, was „alles andere“ bedeutet. Die anderen applicable_shipping_labels dürfen sich nicht überschneiden.

loyalty_programs[]

LoyaltyProgram

Optional. Treuepunkteprogramme, auf die dieser Versandservice beschränkt ist.

service_name

string

Erforderlich. Kostenloser Name des Dienstes. Darf innerhalb des Zielkontos nur einmal vorkommen.

active

bool

Erforderlich. Ein boolescher Wert, der den aktiven Status des Versandservice angibt.

currency_code

string

Der CLDR-Code der Währung, für die dieser Dienst gilt. Muss mit den Preisen in den Preisgruppen übereinstimmen.

delivery_time

DeliveryTime

Erforderlich. Zeit, die für verschiedene Aspekte von der Bestellung bis zur Lieferung des Produkts aufgewendet wird.

shipment_type

ShipmentType

Die Art der Standorte, an die dieser Service Bestellungen liefert.

minimum_order_value

Price

Mindestbestellwert für diese Dienstleistung. Falls festgelegt, bedeutet dies, dass Kunden mindestens diesen Betrag ausgeben müssen. Alle Preise innerhalb einer Dienstleistung müssen in derselben Währung angegeben sein. Kann nicht zusammen mit min_order_value_table festgelegt werden.

minimum_order_value_table

MinimumOrderValueTable

Tabelle mit den Mindestbestellwerten pro Geschäft für die Art der Abholung. Kann nicht zusammen mit min_order_value festgelegt werden.

store_config

StoreConfig

Eine Liste der Geschäfte, von denen Ihre Produkte geliefert werden. Gilt nur für die Versandart „Lokale Lieferung“.

LoyaltyProgram

Das Treuepunkteprogramm eines Händlers.

Felder
loyalty_program_tiers[]

LoyaltyProgramTiers

Optional. Die Stufe des Treuepunkteprogramms dieses Versandservice.

program_label

string

Das ist das Label des Treuepunkteprogramms, das im Merchant Center in den Einstellungen für das Treuepunkteprogramm festgelegt ist. Mit diesem Unterattribut kann Google Ihr Treuepunkteprogramm geeigneten Angeboten zuordnen.

LoyaltyProgramTiers

Teilmenge eines Treuepunkteprogramms für Händler.

Felder
tier_label

string

Das Unterattribut „Stufenlabel“ [tier_label] unterscheidet die Vorteile auf Angebotsebene zwischen den einzelnen Stufen. Dieser Wert wird auch in den Programmeinstellungen im Merchant Center festgelegt und ist für Änderungen an Datenquellen erforderlich, auch wenn Ihr Treuepunkteprogramm nur eine Stufe hat.

ShipmentType

Versandart des Versandservice.

Enums
SHIPMENT_TYPE_UNSPECIFIED Für diesen Service wurde keine Versandart angegeben.
DELIVERY Dieser Service liefert Bestellungen an eine vom Kunden ausgewählte Adresse.
LOCAL_DELIVERY Dieser Service liefert Bestellungen an eine vom Kunden ausgewählte Adresse. Die Bestellung wird von einem Geschäft in der Nähe versandt.
COLLECTION_POINT Dieser Service liefert Bestellungen an eine vom Kunden ausgewählte Adresse. Die Bestellung wird von einer Abholstelle versendet.

StoreConfig

Eine Liste der Geschäfte, von denen Ihre Produkte geliefert werden. Gilt nur für die Versandart „Lokale Lieferung“.

Felder
store_codes[]

string

Optional. Eine Liste der Geschäftscodes, die lokale Lieferung ermöglichen. Wenn das Feld leer ist, muss all_stores „true“ sein.

store_service_type

StoreServiceType

Gibt an, ob alle oder ausgewählte Geschäfte dieses Händlers lokale Lieferungen anbieten.

cutoff_config

CutoffConfig

Konfigurationen für die lokale Lieferung enden für den Tag.

service_radius

Distance

Maximaler Lieferradius. Dies ist nur für die Versandart „Lokale Lieferung“ erforderlich.

CutoffConfig

Konfigurationen für die lokale Lieferung enden für den Tag.

Felder
local_cutoff_time

LocalCutoffTime

Uhrzeit, zu der die lokale Lieferung an diesem Tag endet.

store_close_offset_hours

int64

Nur gültig bei lokaler Lieferung. Annahmeschluss in Stunden vor Geschäftsschluss. Schließt sich mit local_cutoff_time gegenseitig aus.

no_delivery_post_cutoff

bool

Händler können die lokale Lieferung innerhalb von n+1 Tag deaktivieren, wenn sie einen Versandservice für eine lokale Lieferung von n Tagen konfiguriert haben. Wenn zum Beispiel der Versandservice eine Lieferung am selben Tag definiert und der Annahmeschluss überschritten ist, führt das Festlegen dieses Felds auf true dazu, dass der berechnete Versandservicepreis NO_DELIVERY_POST_CUTOFF zurückgegeben wird. Im selben Beispiel führt das Festlegen dieses Felds auf false dazu, dass die berechnete Versandzeit einen Tag beträgt. Dies gilt nur für die lokale Lieferung.

LocalCutoffTime

Uhrzeit, zu der die lokale Lieferung an diesem Tag endet.

Felder
hour

int64

Bestellungen mit lokaler Lieferung müssen bis zu einer bestimmten Stunde aufgegeben werden, damit die Bearbeitung noch am selben Tag erfolgt.

minute

int64

Bestellungen mit minütlicher Lieferung müssen bis spätestens am selben Tag aufgegeben werden.

StoreServiceType

Gibt an, ob alle oder ausgewählte Geschäfte, die vom Händler aufgeführt sind, lokale Lieferungen anbieten.

Enums
STORE_SERVICE_TYPE_UNSPECIFIED Der Diensttyp des Geschäfts wurde nicht angegeben.
ALL_STORES Gibt an, ob alle von diesem Händler aufgeführten Geschäfte (sowohl aktuelle als auch zukünftige) lokale Lieferungen anbieten.
SELECTED_STORES Gibt an, dass die lokale Lieferung nur für die in store_codes aufgeführten Geschäfte möglich ist.

ShippingSettings

Die [Versandeinstellung](https://support.google.com/merchants/answer/6069284) des Händlerkontos.

Felder
name

string

Kennung. Der Ressourcenname der Versandeinstellung. Format: accounts/{account}/shippingSetting

services[]

Service

Optional. Die Liste der Dienste des Zielkontos.

warehouses[]

Warehouse

Optional. Eine Liste der Warenlager, auf die in services verwiesen werden kann.

etag

string

Erforderlich. Dieses Feld wird verwendet, um asynchrone Probleme zu vermeiden. Die Daten zu den Versandeinstellungen dürfen sich zwischen „Anruf abrufen“ und „Anruf einfügen“ nicht geändert haben. Die Nutzenden sollten folgende Schritte ausführen:

  1. Legen Sie das etag-Feld für die erste Erstellung der Versandeinstellung als leeren String fest.

  2. Rufen Sie nach der anfänglichen Erstellung die get-Methode auf, um vor dem Aufruf ein eTag und die aktuellen Versandeinstellungen abzurufen.

  3. Ändern zu gewünschten Versandeinstellungen.

  4. Methode zum Einfügen des Aufrufs mit den gewünschten Informationen zur Versandeinstellung und dem ETag aus Schritt 2

  5. Wenn die Daten der Versandeinstellungen zwischen Schritt 2 und Schritt 4 geändert wurden Die Einfügeanfrage schlägt fehl, da sich das ETag jedes Mal ändert, wenn sich die Daten der Versandeinstellungen ändern. Der Nutzer muss Schritt 2 bis 4 mit dem neuen ETag wiederholen.

Tabelle

Eine Tabelle zur Definition der Preisgruppe, wenn single_value nicht ausdrucksstark genug ist.

Felder
rows[]

Row

Erforderlich. Die Liste der Zeilen, aus denen die Tabelle besteht. Muss genauso lang sein wie row_headers.

name

string

Name der Tabelle Erforderlich für untergeordnete Tabellen, wird bei der Haupttabelle ignoriert.

row_headers

Headers

Erforderlich. Überschriften der Tabellenzeilen.

column_headers

Headers

Überschriften der Tabellenspalten. Optional: Wenn nichts festgelegt ist, hat die Tabelle nur eine Dimension.

TermsOfService

Ein TermsOfService.

Felder
name

string

Kennung. Der Ressourcenname der Version der Nutzungsbedingungen. Format: termsOfService/{version}

region_code

string

Vom CLDR definierter Regionscode. Dies ist entweder ein Land, für das die Nutzungsbedingungen speziell für dieses Land gelten, oder 001, wenn dieselbe TermsOfService in einem beliebigen Land angemeldet sein kann. Wenn Sie weltweit gültige Nutzungsbedingungen unterzeichnen, erwarten wir jedoch, dass ein bestimmtes Land angegeben wird. Das sollte das Land des Händlerunternehmens oder das Land der Programmteilnahme sein.

kind

TermsOfServiceKind

Die Art, für die diese Version der Nutzungsbedingungen gilt.

external

bool

Gibt an, ob die Version dieser Nutzungsbedingungen extern ist. Externe Versionen der Nutzungsbedingungen können nur über externe Prozesse und nicht direkt vom Händler über die Benutzeroberfläche oder die API vereinbart werden.

file_uri

string

URI für die Datei mit den Nutzungsbedingungen, die signierten Nutzern angezeigt werden muss.

TermsOfServiceAgreementState

Diese Ressource stellt den Vereinbarungsstatus für ein bestimmtes Konto und die Art der Nutzungsbedingungen dar. Der Status lautet wie folgt:

  • Wenn der Händler die Nutzungsbedingungen akzeptiert hat, wird accepted ausgefüllt. Andernfalls ist das Feld leer.
  • Wenn der Händler die Nutzungsbedingungen unterzeichnen muss, wird required (erforderlich) ausgefüllt. Andernfalls ist das Feld leer.

Es können sowohl erforderlich als auch akzeptiert vorhanden sein. In diesem Fall ist für die accepted-Nutzungsbedingungen ein Ablaufdatum im Feld valid_until festgelegt. Die required-Nutzungsbedingungen müssen vor dem valid_until akzeptiert werden, damit für das Konto weiterhin eine gültige Vereinbarung besteht. Wenn Drittanbieter die neuen Nutzungsbedingungen akzeptieren, müssen sie den Text anzeigen, der mit der vorliegenden Vereinbarung zu den Nutzungsbedingungen verknüpft ist. Die URL zu der Datei mit dem Text wird unten in der erforderlichen Nachricht als tos_file_uri hinzugefügt. Die tatsächliche Annahme der Nutzungsbedingungen erfolgt durch Aufrufen von Accept in der Ressource TermsOfService.

Felder
name

string

Kennung. Der Ressourcenname der Version der Nutzungsbedingungen. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Das Format der Kennzeichnung ist {TermsOfServiceKind}-{country}. Eine Kennzeichnung könnte beispielsweise so aussehen: MERCHANT_CENTER-US

region_code

string

Regionscode gemäß der Definition in https://cldr.unicode.org/. Dies ist das Land, für das der aktuelle Bundesstaat gilt.

terms_of_service_kind

TermsOfServiceKind

Die Art der Nutzungsbedingungen, die der jeweiligen Version zugeordnet sind.

accepted

Accepted

Die akzeptierten Nutzungsbedingungen dieser Art und für den zugehörigen „region_code“

required

Required

Die erforderlichen Nutzungsbedingungen

TermsOfServiceKind

Die Art der Nutzungsbedingungen.

Enums
TERMS_OF_SERVICE_KIND_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
MERCHANT_CENTER Merchant Center-Anwendung.

TransitTable

Lieferzeittabelle, Anzahl der Werktage, die auf dem Transportweg verbracht wurden, basierend auf Zeilen- und Spaltendimensionen. Es kann entweder min_transit_days, max_transit_days oder transit_time_table festgelegt werden, aber nicht beides.

Felder
postal_code_group_names[]

string

Erforderlich. Eine Liste der Regionsnamen Region.name . Der letzte Wert kann "all other locations" sein. Beispiel: ["zone 1", "zone 2", "all other locations"]. Die angegebenen Postleitzahlengruppen müssen mit dem Lieferland des Dienstes übereinstimmen.

transit_time_labels[]

string

Erforderlich. Eine Liste mit Laufzeitlabels. Der letzte Wert kann "all other labels" sein. Beispiel: ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Erforderlich. Wenn nur ein Dimensionssatz vom Typ postal_code_group_names oder transit_time_labels vorhanden ist, gibt es mehrere Zeilen mit jeweils einem Wert für diese Dimension. Wenn es zwei Dimensionen gibt, entspricht jede Zeile einem postal_code_group_names und Spalten (Werte) einem transit_time_labels.

TransitTimeRow

Wenn nur ein Dimensionssatz vom Typ postal_code_group_names oder transit_time_labels vorhanden ist, gibt es mehrere Zeilen mit jeweils einem Wert für diese Dimension. Wenn es zwei Dimensionen gibt, entspricht jede Zeile einem postal_code_group_names und Spalten (Werte) einem transit_time_labels.

Felder
values[]

TransitTimeValue

Erforderlich. Laufzeitbereich (min–max) in Werktagen.

TransitTimeValue

Laufzeitbereich (min–max) in Werktagen.

Felder
min_transit_days

int32

Minimale Laufzeit in Werktagen. 0 bedeutet Lieferung am selben Tag, 1 eine Lieferung am nächsten Tag.

max_transit_days

int32

Muss größer oder gleich min_transit_days sein.

UnclaimHomepageRequest

Anfragenachricht für die Methode UnclaimHomepage.

Felder
name

string

Erforderlich. Der Name der Startseite, für die kein Anspruch erhoben werden soll. Format: accounts/{account}/homepage

UpdateAccountRequest

Anfragenachricht für die Methode UpdateAccount.

Felder
account

Account

Erforderlich. Die neue Version des Kontos.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

UpdateBusinessIdentityRequest

Anfragenachricht für die Methode UpdateBusinessIdentity.

Felder
business_identity

BusinessIdentity

Erforderlich. Die neue Version der Unternehmensidentität.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

UpdateBusinessInfoRequest

Anfragenachricht für die Methode UpdateBusinessInfo.

Felder
business_info

BusinessInfo

Erforderlich. Die neue Version der Unternehmensinformationen.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

UpdateEmailPreferencesRequest

Anfragenachricht für die Methode "UpdateEmailPreferences".

Felder
email_preferences

EmailPreferences

Erforderlich. E-Mail-Einstellungen, die aktualisiert werden sollen.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

UpdateHomepageRequest

Anfragenachricht für die Methode UpdateHomepage.

Felder
homepage

Homepage

Erforderlich. Die neue Version der Startseite.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

UpdateRegionRequest

Anfragenachricht für die Methode UpdateRegion.

Felder
region

Region

Erforderlich. Die aktualisierte Region.

update_mask

FieldMask

Optional. Die durch Kommas getrennte Feldmaske, die die zu aktualisierenden Felder angibt. Beispiel: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Anfragenachricht für die Methode UpdateUser.

Felder
user

User

Erforderlich. Die neue Version des Nutzers.

Verwenden Sie me für Ihre eigene E-Mail-Adresse, z. B. accounts/{account}/users/me.

update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.

Nutzer

Ein Nutzer.

Felder
name

string

Kennung. Der Ressourcenname des Nutzers. Format: accounts/{account}/user/{email}

Verwenden Sie me für Ihre eigene E-Mail-Adresse, z. B. accounts/{account}/users/me.

state

State

Nur Ausgabe. Der Status des Nutzers.

access_rights[]

AccessRight

Optional. Die Zugriffsrechte, die der Nutzer hat.

Status

Die möglichen Status eines Nutzers.

Enums
STATE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
PENDING Die Bestätigung des Nutzers steht noch aus. In diesem Status muss der Nutzer zuerst die Einladung annehmen, bevor er weitere Aktionen ausführen kann.
VERIFIED Der Nutzer wurde bestätigt.

Wert

Der einzelne Wert einer Preisgruppe oder der Wert der Zelle einer Preisgruppentabelle. Genau eines der folgenden Werte muss festgelegt werden: no_shipping, flat_rate, price_percentage, carrier_rateName oder subtable_name.

Felder
no_shipping

bool

Falls wahr, kann das Produkt nicht versendet werden. Muss „true“ sein, wenn festgelegt, kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

flat_rate

Price

Ein Pauschalpreis. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

price_percentage

string

Prozentualer Anteil des Preises, dargestellt als Zahl in Dezimalschreibweise (z. B. "5.4"). Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

carrier_rate

string

Der Name des vom Transportunternehmen berechneten Preises, der sich auf einen vom Transportunternehmen berechneten Preis in derselben Preisgruppe bezieht. Kann nur festgelegt werden, wenn alle anderen Felder nicht festgelegt sind.

subtable

string

Der Name einer untergeordneten Tabelle. Kann nur in Tabellenzellen festgelegt werden (z. B. nicht für einzelne Werte) und nur, wenn alle anderen Felder nicht festgelegt sind.

Warenlager

Ein Fulfillment-Warehouse, in dem der Lagerbestand gespeichert und abgewickelt wird. Nächstes Tag: 7

Felder
name

string

Erforderlich. Der Name des Warehouse. Darf innerhalb des Kontos nur einmal vorkommen.

shipping_address

Address

Erforderlich. Die Versandadresse des Lagers.

cutoff_time

WarehouseCutoffTime

Erforderlich. Die späteste Uhrzeit, zu der eine Bestellung angenommen und bearbeitet werden kann. Spätere Bestellungen werden am nächsten Tag bearbeitet. Die Uhrzeit basiert auf der Postleitzahl des Lagers.

handling_days

int64

Erforderlich. Die Anzahl der Tage, die in diesem Lager zum Verpacken und Versenden eines Artikels benötigt werden. Dies gilt auf Lagerebene, kann aber auf Angebotsebene anhand der Attribute eines Artikels überschrieben werden.

business_day_config

BusinessDayConfig

Werktage im Lager. Wenn die Richtlinie nicht konfiguriert ist, ist der Zeitraum standardmäßig Montag bis Freitag.

WarehouseBasedDeliveryTime

Gibt an, dass die Lieferdauer pro Lager (Herkunftsort des Versands) basierend auf den Einstellungen des ausgewählten Transportunternehmens berechnet werden soll. Wenn dies festgelegt ist, darf in delivery_time kein anderes zeitbezogenes Feld festgelegt werden.

Felder
carrier

string

Erforderlich. Mobilfunkanbieter, z. B. "UPS" oder "Fedex".

carrier_service

string

Erforderlich. Versandservice wie "ground" oder "2 days". Der Name des Dienstes muss in der Liste „eddSupportedServices“ enthalten sein.

warehouse

string

Erforderlich. Warehouse-Name. Dies sollte mit [warehouse][ShippingSetting.warehouses.name] übereinstimmen.

WarehouseCutoffTime

Die späteste Uhrzeit, zu der eine Bestellung angenommen und bearbeitet werden kann. Spätere Bestellungen werden am nächsten Tag bearbeitet. Die Uhrzeit basiert auf der Postleitzahl des Lagers.

Felder
hour

int32

Erforderlich. Uhrzeit des Annahmeschlusses, bis zu dem eine Bestellung aufgegeben werden muss, damit sie noch am selben Tag im Lager bearbeitet wird. Stunde basiert auf der Zeitzone des Warenlagers.

minute

int32

Erforderlich. Minute des Annahmeschlusses, bis zu dem eine Bestellung aufgegeben werden muss, damit sie noch am selben Tag im Lager bearbeitet wird. Die Minute basiert auf der Zeitzone des Warenlagers.