Package google.shopping.merchant.accounts.v1beta

Indeks

AccountIssueService

Usługa obsługująca interfejs AccountIssueService API.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Lista wszystkich problemów z kontem Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AccountTaxService

Zarządza danymi o ustawieniach podatków na poziomie konta.

Ten interfejs API definiuje ten model zasobów:

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

Zwraca reguły podatkowe pasujące do warunków GetAccountTaxRequest

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

Zawiera listę ustawień podatków tylko dla subkont na Twoim koncie Merchant Center. Tę metodę można wywołać tylko na multikoncie klientów. W przeciwnym razie spowoduje to wyświetlenie błędu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

Aktualizuje ustawienia podatków na koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AccountsService

Usługa obsługująca Account API.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Tworzy samodzielne konto Merchant Center z dodatkową konfiguracją. Dodaje użytkownika, który przesłał prośbę, w roli administratora nowego konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Usuwa określone konto niezależnie od jego typu: samodzielne, MCA lub subkonto. Usunięcie multikonta klientów spowoduje usunięcie wszystkich jego subkont. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Pobiera konto z Twojego konta Merchant Center. Po wstawieniu, zaktualizowaniu lub usunięciu konta może minąć kilka minut, zanim zmiany zaczną obowiązywać.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Zawiera listę kont, do których użytkownik nawiązuje połączenie, zgodnie z ograniczeniami żądania, takimi jak rozmiar strony lub filtry. Nie jest to jedynie lista subkont multikonta klientów, lecz wszystkich kont, do których ma dostęp użytkownik łączący, w tym innych multikont klientów, połączonych kont, samodzielnych kont itd.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Wymień wszystkie subkonta danego multikonta klientów. Jest to wygodny kod zapewniający bardziej wydajną metodę ListAccounts. Ta metoda zapewni takie same wyniki jak wywołanie metody ListsAccounts z tym filtrem: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aktualizuje konto niezależnie od jego typu: samodzielne, multikonto klientów czy subkonto. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

BusinessIdentityService

Usługa obsługująca interfejs API firmy tożsamości.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Pobiera tożsamość firmy z konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Aktualizuje tożsamość firmy na koncie. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

BusinessInfoService

Usługa obsługująca interfejs API informacji o firmie.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Pobiera informacje o firmie z konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Aktualizuje informacje o firmie na koncie. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

EmailPreferencesService

Usługa obsługująca interfejs EmailPreferences API.

Ta usługa zezwala tylko na pobieranie i aktualizowanie ustawień e-mail dla uwierzytelnionego użytkownika.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Zwraca ustawienia e-mail użytkownika konta Merchant Center.

Aby pobrać ustawienia uwierzytelnionego użytkownika, użyj aliasu name=accounts/*/users/me/emailPreferences.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Aktualizuje ustawienia e-mail użytkownika konta Merchant Center. Użytkownicy MCA powinni wybrać konto MCA, a nie subkonto MCA.

Preferencje, które nie są wyraźnie wybrane w masce aktualizacji, nie zostaną zaktualizowane.

W przypadku aktualizacji nie można określić wartości stanu zgody NIEPOTWIERDZONA.

Aby zaktualizować ustawienia uwierzytelnionego użytkownika, użyj aliasu name=accounts/*/users/me/emailPreferences.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

HomepageService

Usługa obsługująca interfejs API dla strony głównej sklepu.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Zgłasza prawa do strony głównej sklepu. Ta metoda wymaga dostępu administracyjnego.

Jeśli strona główna została już zarezerwowana, nastąpi ponowne sprawdzenie weryfikacji (chyba że sprzedawca jest zwolniony z zgłaszania praw do strony, co też jest zwolnione z weryfikacji) i zwróci prawidłową odpowiedź. Jeśli nie będzie można zweryfikować własności, spowoduje to wyświetlenie błędu, ale nie spowoduje usunięcia roszczenia. W przypadku niepowodzenia zostanie wyświetlony kanoniczny komunikat o błędzie: * PERMISSION_DENIED: użytkownik nie ma wymaganych uprawnień na tym koncie Merchant Center; * FAILED_PREcondition: - Konto nie jest kontem Merchant Center; - Konto Merchant Center nie ma strony głównej; - zgłoszenie nie powiodło się (w tym przypadku komunikat o błędzie będzie zawierać więcej informacji).

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Pobiera stronę główną sklepu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Usuwa prawa do strony głównej sklepu. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Aktualizuje stronę główną sklepu. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

OnlineReturnPolicyService

Usługa ułatwia zarządzanie konfiguracją zasad zwrotów sprzedawcy w przypadku rozmyślenia się z zakupu, która obejmuje zasady zwrotów zarówno w przypadku reklam, jak i bezpłatnych informacji

programów. Ten interfejs API definiuje ten model zasobów:

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Pobiera istniejące zasady zwrotów.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Wyświetla listę wszystkich istniejących zasad zwrotów.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ProgramsService

Usługa zarządzania programem.

Programy zapewniają mechanizm dodawania funkcji do kont sprzedawców. Typowym przykładem jest program Bezpłatne informacje o produkcie, który umożliwia bezpłatne wyświetlanie produktów ze sklepu sprzedawcy w Google.

Ta usługa udostępnia metody uzyskiwania informacji o udziale sprzedawcy we wszystkich dostępnych programach, a także metody wprost włączania lub wyłączania udziału w każdym z nich.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Wyłącz na koncie udział w określonym programie. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Włącz na koncie udział w określonym programie. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Pobiera określony program dla konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Pobiera wszystkie programy na koncie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

RegionsService

Zarządza konfiguracją regionów.

Ten interfejs API definiuje ten model zasobów:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Tworzy definicję regionu na koncie Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Usuwa definicję regionu z Twojego konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Pobiera region zdefiniowany na Twoim koncie Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Wyświetla listę regionów na Twoim koncie Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Aktualizuje definicję regionu na koncie Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ShippingSettingsService

Usługa, która pobiera informacje o ustawieniach dostawy metodą wywołania metody dla metody w interfejsie API sprzedawcy.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Pobieranie informacji o ustawieniach dostawy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Zastąp ustawienia dostawy u sprzedawcy ustawieniem dostawy. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

TermsOfServiceAgreementStateService

Usługa obsługująca interfejs TermsOfServiceAgreementState API.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Zwraca stan umowy dotyczącej warunków korzystania z usługi.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Pobiera stan umowy na warunki korzystania z aplikacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

TermsOfServiceService

Usługa obsługująca interfejs TermsOfService API.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Akceptuje TermsOfService. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Pobiera obiekt TermsOfService powiązany z podaną wersją.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Pobiera najnowszą wersję usługi TermsOfService dla określonych obiektów kind i region_code.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UserService

Usługa obsługująca interfejs API użytkownika.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Tworzy użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Usuwa użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetUser

rpc GetUser(GetUserRequest) returns (User)

Pobiera użytkownika konta Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Zawiera listę wszystkich użytkowników konta Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Aktualizuje użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AcceptTermsOfServiceRequest

Komunikat żądania dla metody AcceptTermsOfService.

Pola
name

string

Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: termsOfService/{version}

account

string

Wymagane. Konto, w przypadku którego chcesz zaakceptować Warunki korzystania z usługi.

region_code

string

Wymagane. Kod regionu określony przez CLDR. Jest to kraj, w którym Warunki korzystania z usługi obowiązują w danym kraju, lub kod 001, jeśli obowiązują na całym świecie.

Zaakceptowano

Opisuje zaakceptowane warunki korzystania z usługi.

Pola
terms_of_service

string

zaakceptowane termsOfService.

accepted_by

string

Konto, na którym została zarejestrowana akceptacja. Może to być samo konto lub, w przypadku subkont, konto MCA.

valid_until

Date

Jeśli jest ustawiony, zawiera informację, że zaakceptowane TermsOfService obowiązują tylko do końca tego dnia (według strefy czasowej UTC). Nowy kod musisz zaakceptować przed tym terminem. Informacje na temat wymaganych TermsOfService znajdują się w komunikacie Wymagane.

AccessRight

Prawo dostępu.

Wartości w polu enum
ACCESS_RIGHT_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
STANDARD Standardowe prawa dostępu.
ADMIN Uprawnienia dostępu administratora.
PERFORMANCE_REPORTING Użytkownicy z tym uprawnieniem mają dostęp do skuteczności i statystyk.

Konto

Konto.

Pola
name

string

Identyfikator. Nazwa zasobu konta. Format: accounts/{account}

account_id

int64

Tylko dane wyjściowe. Identyfikator konta.

account_name

string

Wymagane. Czytelna dla człowieka nazwa konta. Więcej informacji znajdziesz w polach nazwa sklepu i nazwa firmy.

adult_content

bool

Określa, czy to konto zawiera treści dla dorosłych.

test_account

bool

Tylko dane wyjściowe. Wskazuje, czy jest to konto testowe.

time_zone

TimeZone

Wymagane. Strefa czasowa konta.

Przy zapisach time_zone ustawia zarówno reporting_time_zone, jak i display_time_zone.

W przypadku odczytów time_zone zawsze zwraca wartość display_time_zone. Jeśli konto display_time_zone nie istnieje, pole time_zone jest puste.

language_code

string

Wymagane. Kod języka BCP-47 konta, na przykład en-US lub sr-Latn.

AccountIssue

AccountIssue.

Pola
name

string

Identyfikator. Nazwa zasobu, którego dotyczy problem na koncie. Format: accounts/{account}/issues/{id}

title

string

Zlokalizowany tytuł problemu.

severity

Severity

Ogólna ważność problemu.

impacted_destinations[]

ImpactedDestination

Wpływ tego problemu na różne miejsca docelowe.

detail

string

Dalsze zlokalizowane informacje o tym problemie.

documentation_uri

string

Link do Centrum pomocy Merchant Center z dodatkowymi informacjami o problemie i sposobie jego rozwiązania.

ImpactedDestination

Wpływ problemu na miejsce docelowe.

Pola
impacts[]

Impact

(negatywny) wpływ na różne regiony w danym miejscu docelowym;

reporting_context

ReportingContextEnum

Kontekst raportowania, którego to dotyczy.

Wpływ

Wpływ problemu na region.

Pola
region_code

string

Kod regionu CLDR, w którym występuje problem.

severity

Severity

Waga problemu w miejscu docelowym i regionie.

Poziom ważności

Wszystkie możliwe poziomy ważności problemów.

Wartości w polu enum
SEVERITY_UNSPECIFIED Waga jest nieznana.
CRITICAL Ten problem powoduje, że oferty się nie wyświetlają.
ERROR Ten problem może w przyszłości wpływać na oferty lub wskazywać na problemy z ofertami.
SUGGESTION Problem to sugestia poprawy.

AccountTax

Ustawienia podatków na koncie sprzedawcy. Wszystkie metody wymagają roli administratora.

Pola
name

string

Identyfikator. Nazwa ustawienia podatków. Format: „{account_tax.name=accounts/{konto}}”

account

int64

Tylko dane wyjściowe. Identyfikator konta, do którego należą te ustawienia podatków.

tax_rules[]

TaxRule

Reguły podatkowe. Zdefiniuj reguły podatkowe w każdym regionie. Jeśli dla danego regionu nie ma reguły, podatek nie zostanie podany.

Adres

Adres dostawy magazynu.

Pola
street_address

string

Część adresu na poziomie ulicy. Na przykład: 111w 31st Street.

city

string

Wymagane. Miasto, miejscowość lub gmina. Może obejmować również zależne miejscowości lub dzielnice (np. dzielnice lub przedmieścia).

administrative_area

string

Wymagane. Jednostka podziału administracyjnego kraju najwyższego poziomu. Na przykład stan taki jak Kalifornia („CA”) lub prowincja taka jak Quebec („QC”).

postal_code

string

Wymagane. Kod pocztowy (na przykład „94043”).

region_code

string

Wymagane. Kod kraju CLDR (np. „PL”).

BusinessDayConfig

Dni robocze w magazynie.

Pola
business_days[]

Weekday

Wymagane. Zwykłe dni robocze. Pole nie może być puste.

Dni powszednie

Wartości w polu enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Zbieranie informacji związanych z tożsamością firmy.

Pola
name

string

Identyfikator. Nazwa zasobu tożsamości firmy. Format: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

Opcjonalnie. Określa, czy firma przedstawia się jako black-owned (firma należąca do osoby czarnej). To opcjonalne pole będzie dostępne tylko dla sprzedawców, których kraj prowadzenia działalności to US. Nie dotyczy też platform handlowych ani sprzedawców na platformach handlowych.

women_owned

IdentityAttribute

Opcjonalnie. Określa, czy firma przedstawia się jako należąca do kobiety. To opcjonalne pole będzie dostępne tylko dla sprzedawców, których kraj prowadzenia działalności to US. Nie dotyczy też platform handlowych ani sprzedawców na platformach handlowych.

veteran_owned

IdentityAttribute

Opcjonalnie. Określa, czy firma przedstawia się jako należąca do weterana. To opcjonalne pole będzie dostępne tylko dla sprzedawców, których kraj prowadzenia działalności to US. Nie dotyczy też platform handlowych ani sprzedawców na platformach handlowych.

latino_owned

IdentityAttribute

Opcjonalnie. Określa, czy firma przedstawia się jako firma latynoska. To opcjonalne pole będzie dostępne tylko dla sprzedawców, których kraj prowadzenia działalności to US. Nie dotyczy też platform handlowych ani sprzedawców na platformach handlowych.

small_business

IdentityAttribute

Opcjonalnie. Określa, czy dana firma przedstawia się jako mała firma. To opcjonalne pole będzie dostępne tylko dla sprzedawców, których kraj prowadzenia działalności to US. Nie ma też zastosowania na platformach handlowych.

IdentityAttribute

Wszystkie informacje dotyczące atrybutu tożsamości.

Pola
identity_declaration

IdentityDeclaration

Wymagane. Deklaracja tożsamości dla tego atrybutu.

IdentityDeclaration

Wszystkie możliwe ustawienia dotyczące deklaracji tożsamości.

Wartości w polu enum
IDENTITY_DECLARATION_UNSPECIFIED Wartość domyślna wskazująca, że nie dokonano wyboru.
SELF_IDENTIFIES_AS Wskazuje, że konto identyfikuje się z atrybutem.
DOES_NOT_SELF_IDENTIFY_AS Wskazuje, że konto nie identyfikuje się z tym atrybutem.

PromotionsConsent

Wszystkie możliwe ustawienia dotyczące promocji związanych z tożsamością firmy.

Wartości w polu enum

BusinessInfo

Zbieranie informacji o firmie.

Pola
name

string

Identyfikator. Nazwa zasobu informacji o firmie. Format: accounts/{account}/businessInfo

address

PostalAddress

Opcjonalnie. Adres firmy.

phone

PhoneNumber

Opcjonalnie. Numer telefonu firmy.

phone_verification_state

PhoneVerificationState

Tylko dane wyjściowe. Stan weryfikacji telefonicznej firmy.

customer_service

CustomerService

Opcjonalnie. Obsługa klienta w firmie.

CarrierRate

Lista stawek przewoźnika, do których można się odwołać w: main_table lub single_value.

Pola
name

string

Wymagane. Nazwa stawki przewoźnika. Wartość nie może się powtarzać w każdej grupie stawek.

carrier

string

Wymagane. Usługa przewoźnika, na przykład "UPS" lub "Fedex".

carrier_service

string

Wymagane. Usługa przewoźnika, na przykład "ground" lub "2 days".

origin_postal_code

string

Wymagane. Punkt początkowy dostawy dla stawki tego przewoźnika.

percentage_adjustment

string

Opcjonalnie. Mnożący modyfikator stawki dostawy w postaci liczby w zapisie dziesiętnym. Może być ujemna. Na przykład "5.4" zwiększa stawkę o 5,4%, a "-3" obniża ją o 3%.

flat_adjustment

Price

Opcjonalnie. Addytywny modyfikator stawki dostawy. Może być ujemna. Na przykład { "amount_micros": 1, "currency_code" : "USD" } dodaje do stawki 1 zł, a { "amount_micros": -3, "currency_code" : "USD" } usuwa z niej 3 zł.

ClaimHomepageRequest

Komunikat żądania dla metody ClaimHomepage.

Pola
name

string

Wymagane. Nazwa strony głównej, do której chcesz zgłosić prawa. Format: accounts/{account}/homepage

CreateAndConfigureAccountRequest

Komunikat żądania dla metody CreateAndConfigureAccount.

Pola
account

Account

Wymagane. Konto, które zostanie utworzone.

users[]

CreateUserRequest

Opcjonalnie. Użytkownicy, którzy zostaną dodani do konta.

service[]

AddAccountService

Opcjonalnie. Jeśli zostanie określona, podczas tworzenia zostanie zainicjowana usługa konta między utworzonym kontem a kontem dostawcy.

accept_terms_of_service

AcceptTermsOfService

Opcjonalnie. Warunki korzystania z usługi do zaakceptowania natychmiast po utworzeniu konta.

AcceptTermsOfService

Odwołanie do zasobu Warunków korzystania z usługi.

Pola
name

string

Wymagane. Nazwa zasobu wersji warunków korzystania z usługi.

region_code

string

Wymagane. Kod regionu określony przez CLDR. Wybierz kraj, w którym Warunki korzystania z usługi obowiązują w danym kraju, lub 001, jeśli obowiązują na całym świecie.

AddAccountService

Dodatkowe instrukcje dodawania usług konta podczas jego tworzenia.

Pola
Pole sumy service_type. Obecnie obsługiwany jest tylko typ konta nadrzędnego Multikonta klientów. service_type może mieć tylko jedną z tych wartości:
account_aggregation

Empty

Dostawca to pośrednik dla konta.

provider

string

Opcjonalnie. Dostawca usługi. Format: accounts/{account}

CreateRegionRequest

Komunikat żądania dla metody CreateRegion.

Pola
parent

string

Wymagane. Konto, dla którego chcesz utworzyć region. Format: accounts/{account}

region_id

string

Wymagane. Identyfikator regionu unikalny dla wszystkich regionów tego samego konta.

region

Region

Wymagane. Region do utworzenia.

CreateUserRequest

Komunikat żądania dla metody CreateUser.

Pola
parent

string

Wymagane. Nazwa zasobu konta, dla którego zostanie utworzony użytkownik. Format: accounts/{account}

user_id

string

Wymagane. Adres e-mail użytkownika (na przykład john.doe@gmail.com).

user

User

Wymagane. Użytkownik, który ma zostać utworzony.

CustomerService

Informacje o obsłudze klienta.

Pola
uri

string

Opcjonalnie. Identyfikator URI, pod którym można znaleźć obsługę klienta.

email

string

Opcjonalnie. Adres e-mail, pod którym można skontaktować się z obsługą klienta.

phone

PhoneNumber

Opcjonalnie. Numer telefonu, pod którym można zadzwonić do obsługi klienta.

CutoffTime

Definicja ostatecznego terminu składania zamówień w dniach roboczych.

Pola
hour

int32

Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało przetworzone tego samego dnia.

minute

int32

Wymagane. Minuta ostatecznych terminów, do których należy złożyć zamówienie, aby zostało przetworzone tego samego dnia.

time_zone

string

Wymagane. Identyfikator strefy czasowej, na przykład „Europa/Zurych”.

DeleteAccountRequest

Komunikat żądania dla metody DeleteAccount.

Pola
name

string

Wymagane. Nazwa konta do usunięcia. Format: accounts/{account}

DeleteRegionRequest

Komunikat żądania dla metody DeleteRegion.

Pola
name

string

Wymagane. Nazwa regionu do usunięcia. Format: accounts/{account}/regions/{region}

DeleteUserRequest

Komunikat żądania dla metody DeleteUser.

Pola
name

string

Wymagane. Nazwa użytkownika, którego konto chcesz usunąć. Format: accounts/{account}/users/{email}

Można też usunąć użytkownika odpowiadającego rozmówcy, używając pola me zamiast adresu e-mail, jak w przykładzie accounts/{account}/users/me.

DeliveryTime

Czas potrzebny na wykonanie różnych czynności – od złożenia zamówienia po dostarczenie produktu

Pola
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Opcjonalnie. Informuje, że czas dostawy powinien być obliczany dla poszczególnych magazynów (lokalizacji wysyłki) na podstawie ustawień wybranego przewoźnika. Gdy ta opcja jest skonfigurowana, w [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] nie należy ustawiać żadnego innego pola dotyczącego czasu przewozu.

min_transit_days

int32

Minimalna liczba dni roboczych przewozu. 0 oznacza dostawę tego samego dnia, 1 oznacza dostawę następnego dnia. Należy ustawić wartość min_transit_days, max_transit_days lub transit_time_table, ale nie obie.

max_transit_days

int32

Maksymalna liczba dni roboczych na dostawę. 0 oznacza dostawę tego samego dnia, 1 oznacza dostawę następnego dnia. Wartość nie może być mniejsza niż min_transit_days.

cutoff_time

CutoffTime

Definicja ostatecznego terminu składania zamówień w dniach roboczych. Jeśli nie skonfigurujesz ostatecznych terminów, zostanie ustawiony domyślny czas na 8:00 czasu PST.

min_handling_days

int32

Minimalna liczba dni roboczych potrzebnych do wysyłki zamówienia. Wartość 0 oznacza, że wysyłka została wysłana tego samego dnia, a 1 oznacza dostawę następnego dnia.

max_handling_days

int32

Maksymalna liczba dni roboczych potrzebnych do wysłania zamówienia. Wartość 0 oznacza, że wysyłka została wysłana tego samego dnia, a 1 oznacza dostawę następnego dnia. Wartość nie może być mniejsza niż min_handling_days.

transit_time_table

TransitTable

Tabela czasu przewozu, liczba dni roboczych podczas przesyłania na podstawie wymiarów wierszy i kolumn. Można ustawić jedną z tych wartości: min_transit_days, max_transit_days lub transit_time_table, ale nie oba jednocześnie.

handling_business_day_config

BusinessDayConfig

Dni robocze, w których możliwa jest obsługa zamówień. Jeśli nie zostanie podany, przyjmuje się, że przyjmujemy dni robocze od poniedziałku do piątku.

transit_business_day_config

BusinessDayConfig

Dni robocze, w których zamówienia mogą być przesyłane. Jeśli nie zostanie podany, przyjmuje się, że przyjmujemy dni robocze od poniedziałku do piątku.

DisableProgramRequest

Komunikat żądania dla metody DisableProgram.

Pola
name

string

Wymagane. Nazwa programu, w którym nie można korzystać z danego konta. Format: accounts/{account}/programs/{program}

Odległość

Maksymalny promień dostawy. Jest to wymagane tylko w przypadku dostawy lokalnej.

Pola
value

int64

Liczba całkowita odległości.

unit

Unit

Jednostka może różnić się w zależności od kraju. Jej parametry obejmują mile i kilometry.

Jednostka

Jednostka może różnić się w zależności od kraju. Jej parametry obejmują mile i kilometry.

Wartości w polu enum
UNIT_UNSPECIFIED Nie określono jednostki
MILES Jednostka w milach
KILOMETERS Jednostka w kilometrach

EmailPreferences

Kategorie powiadomień, które użytkownik włączył lub z których zrezygnował. Ustawienia powiadomień e-mail nie obejmują obowiązkowych powiadomień, ponieważ użytkownicy nie mogą zrezygnować z ich otrzymywania.

Pola
name

string

Identyfikator. Nazwa pola EmailPreferences. Punkt końcowy jest obsługiwany tylko w przypadku uwierzytelnionego użytkownika.

news_and_tips

OptInState

Opcjonalnie. Informacje o nowych funkcjach, wskazówki i sprawdzone metody.

OptInState

Włącz stan ustawień powiadomień e-mail.

Wartości w polu enum
OPT_IN_STATE_UNSPECIFIED Nie określono stanu akceptacji.
OPTED_OUT Użytkownik zrezygnował z otrzymywania tego typu e-maili.
OPTED_IN Użytkownik wyraził zgodę na otrzymywanie tego typu e-maili.
UNCONFIRMED Użytkownik wyraził zgodę na otrzymywanie tego typu e-maili i został już wysłany e-mail z potwierdzeniem, ale nie potwierdził jeszcze zgody na otrzymywanie e-maili (dotyczy tylko niektórych krajów).

EnableProgramRequest

Komunikat żądania dla metodyEnableProgram.

Pola
name

string

Wymagane. Nazwa programu, w którym można wziąć udział w przypadku danego konta. Format: accounts/{account}/programs/{program}

GetAccountRequest

Komunikat żądania dla metody GetAccount.

Pola
name

string

Wymagane. Nazwa konta do pobrania. Format: accounts/{account}

GetAccountTaxRequest

Prośba o pobranie ustawień podatków

Pola
name

string

Wymagane. Nazwa, od której będą pobierane ustawienia podatków

GetBusinessIdentityRequest

Komunikat żądania dla metody GetBusinessIdentity.

Pola
name

string

Wymagane. Nazwa zasobu tożsamości firmy. Format: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Komunikat żądania dla metody GetBusinessInfo.

Pola
name

string

Wymagane. Nazwa zasobu informacji o firmie. Format: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Żądanie komunikatu dotyczącego metody GetEmailPreferences.

Pola
name

string

Wymagane. Nazwa zasobu EmailPreferences. Format: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Komunikat żądania dla metody GetHomepage.

Pola
name

string

Wymagane. Nazwa strony głównej do pobrania. Format: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Komunikat żądania dla metody GetOnlineReturnPolicy.

Pola
name

string

Wymagane. Nazwa zasady zwrotów do pobrania. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Komunikat żądania metody GetProgram.

Pola
name

string

Wymagane. Nazwa programu do pobrania. Format: accounts/{account}/programs/{program}

GetRegionRequest

Komunikat żądania dla metody GetRegion.

Pola
name

string

Wymagane. Nazwa regionu do pobrania. Format: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Komunikat żądania dla metody GetShippingSetting.

Pola
name

string

Wymagane. Nazwa ustawienia dostawy do pobrania. Format: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Komunikat żądania dla metody GetTermsOfServiceAgreementState.

Pola
name

string

Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: accounts/{account}/termsOfServiceAgreementState/{identifier}

GetTermsOfServiceRequest

Komunikat żądania dla metody GetTermsOfService.

Pola
name

string

Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: termsOfService/{version}

GetUserRequest

Komunikat żądania dla metody GetUser.

Pola
name

string

Wymagane. Nazwa użytkownika do pobrania. Format: accounts/{account}/users/{email}

Możliwe jest też pobranie informacji o użytkowniku powiązanym z rozmówcą, używając parametru me zamiast adresu e-mail (jak w przykładzie accounts/{account}/users/me).

nagłówków,

Niepusta lista nagłówków wierszy lub kolumn tabeli. Należy ustawić tylko jedną z tych wartości: prices, weights, num_items, postal_code_group_names lub location.

Pola
prices[]

Price

Wymagane. Lista górnych granic ceny zamówienia uwzględniającego. Wartość ostatniej ceny może być wartością nieskończoności przez ustawienie ceny amount_micros = -1. Na przykład [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] reprezentuje nagłówki „<= 10 USD”, „<= 500 USD” i > 500 USD. Wszystkie ceny w ramach usługi muszą mieć tę samą walutę. Pole nie może być puste. Musi być liczbą dodatnią z wyjątkiem -1. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

weights[]

Weight

Wymagane. Lista górnych granic wagi zamówienia uwzględniającego. Wartość ostatniej wagi może być nieskończonością przez ustawienie ceny amount_micros = -1. Na przykład [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] reprezentuje nagłówki „<= 10kg”, „<= 50kg” i ">50 kg. Wszystkie wagi w ramach usługi muszą mieć tę samą jednostkę. Pole nie może być puste. Musi być liczbą dodatnią z wyjątkiem -1. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

number_of_items[]

string

Wymagane. Lista górnych granic uwzględniających liczbę elementów. Ostatnia wartość może wynosić "infinity". Na przykład ["10", "50", "infinity"] reprezentuje nagłówki „<= 10 elementów”, „<= 50 elementów” i > 50 elementów. Pole nie może być puste. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

postal_code_group_names[]

string

Wymagane. Lista nazw grup pocztowych. Ostatnia wartość może wynosić "all other locations". Przykład: ["zone 1", "zone 2", "all other locations"]. Podane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi. Pole nie może być puste. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

locations[]

LocationIdSet

Wymagane. Lista zestawów identyfikatorów lokalizacji. Pole nie może być puste. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

Strona główna

Strona główna sklepu.

Pola
name

string

Identyfikator. Nazwa zasobu strony głównej sklepu. Format: accounts/{account}/homepage

claimed

bool

Tylko dane wyjściowe. Określa, czy zgłoszono prawa do strony głównej. Więcej informacji: https://support.google.com/merchants/answer/176793.

uri

string

Wymagane. Identyfikator URI (zwykle URL) strony głównej sklepu.

InsertShippingSettingsRequest

Komunikat żądania dla metody InsertShippingSetting.

Pola
parent

string

Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto}

shipping_setting

ShippingSettings

Wymagane. Nowa wersja konta.

ListAccountIssuesRequest

Komunikat żądania dla metody ListAccountIssues.

Pola
parent

string

Wymagane. Element nadrzędny, który jest właścicielem tej kolekcji problemów. Format: accounts/{account}

page_size

int32

Opcjonalnie. Maksymalna liczba numerów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 50 użytkowników. Maksymalna wartość to 100; wartości powyżej 100 zostaną zmienione na 100

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListAccountIssues. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListAccountIssues muszą być zgodne z wywołaniem, które dostarczyło token strony.

language_code

string

Opcjonalnie. Problemy w odpowiedzi będą miały pola z możliwością odczytania przez człowieka w danym języku. Format to BCP-47, na przykład en-US lub sr-Latn. Jeśli nie podasz wartości, zostanie użyta en-US.

time_zone

TimeZone

Opcjonalnie. Strefa czasowa IANA używana do lokalizowania godzin w polach zrozumiałych dla człowieka. Przykład: „Ameryka/Los_Angeles”. Jeśli nie zostanie ustawiona, używana będzie kategoria „America/Los_Angeles”.

ListAccountIssuesResponse

Komunikat odpowiedzi dla metody ListAccountIssues.

Pola
account_issues[]

AccountIssue

Problemy z określonego konta.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListAccountTaxRequest

Żądanie wyświetlenia wszystkich ustawień podatków na subkoncie tylko sprzedawcy, który wysłał prośbę. Ta metoda może zostać wywołana tylko z multikonta klientów. W przeciwnym razie spowoduje wyświetlenie błędu.

Pola
parent

string

Wymagane. Konto nadrzędne, do którego należy podatek od konta. Format: konta/{konto}

page_size

int32

Maksymalna liczba ustawień podatków do zwrócenia w odpowiedzi, używana na potrzeby stronicowania.

page_token

string

Token zwrócony przez poprzednie żądanie.

ListAccountTaxResponse

Odpowiedź na prośbę o listę podatkową konta Ta metoda może być wywoływana tylko na multikoncie klientów; w przeciwnym razie zwróci błąd.

Pola
account_taxes[]

AccountTax

Strona ustawień podatków na koncie

next_page_token

string

Token pobierania następnej strony ustawień podatków na koncie.

ListAccountsRequest

Komunikat żądania dla metody ListAccounts.

Pola
page_size

int32

Opcjonalnie. Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 250 kont. Maksymalna wartość to 500. Wartości powyżej 500 zostaną zmienione na 500.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListAccounts. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListAccounts muszą być zgodne z wywołaniem, które dostarczyło token strony.

filter

string

Opcjonalnie. Opcjonalny filtr, który zwraca tylko te konta, które pasują do filtra.

Oto kilka przykładów prawidłowych filtrów:

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

Filtry na poziomie konta mają taką semantykę:

  • accountName Dotyczy to pola accountName na koncie.
  • relationship(...) Wskazuje relację konta z innym kontem. W ramach funkcji tę relację można dodatkowo określić.

Filtry na poziomie relacji mają taką semantykę:

  • providerIdJest to numeryczny identyfikator konta, które jest drugą częścią relacji. Jeśli np. filtr powinien ograniczać się do kont powiązanych z kontem accounts/name/123, pole providerId powinno zostać odfiltrowane jako providerId = 123.
  • callerHasAccessToProvider() Spowoduje to ograniczenie powstałych kont do takich kont, które są powiązane z innym kontem, gdzie użytkownik dzwoniący ma też dostęp do drugiego elementu relacji (lub dostawcy).
  • externalAccountIdOdnosi się do identyfikatora konta zewnętrznego skonfigurowanego na potrzeby relacji.
  • accountIdAliasOdnosi się to do aliasu identyfikatora konta skonfigurowanego dla relacji.
  • service(...) Dotyczy to usługi świadczonej w ramach relacji. Uwaga: relacja między dwoma kontami może obejmować wiele usług.

Filtry na poziomie usługi mają taką semantykę:

  • handshakeState Odnosi się do stanu uzgadniania połączenia usługi. Po ustanowieniu usługi musi ona czasem zostać najpierw zatwierdzona przez innych lub obu członków relacji. Dlatego usługa może mieć stan PENDING lub APPROVED.
  • type. Odnosi się do typu usługi. Możliwe wartości:
    • ACCOUNT_MANAGEMENT Dostawca zarządza kontem.
    • ACCOUNT_AGGREGATION Dostawca to pośrednik w zakresie konta.

Filtr jest zgodny z podzbiorem specyfikacji filtra AIP i z jego formalną gramatyką EBNF. Gramatyka tego filtra jest bardziej restrykcyjna i precyzyjna.

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

Dodatkowo obowiązują te zasady:

  • Każde pole w kontekście może się pojawić tylko raz (np. filtr można filtrować według kolumny accountName tylko raz na poziomie konta lub tylko raz na każdym poziomie relacji można użyć wartości providerId).
  • W przypadku pól ciągu znaków (takich jak accountName lub accountIdAlias) można wyrazić operator CONTAINS, umieszczając zapytanie w elemencie *. Na przykład funkcja accountName = "*foo*" zwróci wszystkie konta z parametrem accountName zawierającym foo. Operator NOT_CONTAINS można wyrażać ortogonalnie przy użyciu !=. Na przykład funkcja accountName != "*foo*" zwróci wszystkie konta z parametrem accountName, który nie zawiera foo. Uwaga: można wyszukiwać konta, których atrybut accountName zawiera gwiazdkę * i pozwala na wyszukiwanie za pomocą funkcji ***.
  • Dodatkowe spacje są ignorowane.
  • Wszystkie wartości, oprócz wartości liczbowych, muszą być ujęte w cudzysłów podwójny.
  • W przypadku rozdzielenia spójności po każdej stronie muszą używać nawiasów, nawet jeśli spójnik zawiera tylko jedno wyrażenie. Nawiasy nie są dozwolone nigdzie indziej, z wyjątkiem wywołań funkcji (takich jak relationship lub service). W ten sposób wyraźnie widać, że spójniki wiążą się silniej niż dysocjacje logiczne.

ListAccountsResponse

Komunikat odpowiedzi dla metody ListAccounts.

Pola
accounts[]

Account

Konta pasujące do: ListAccountsRequest.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListOnlineReturnPoliciesRequest

Komunikat żądania dla metody ListOnlineReturnPolicies.

Pola
parent

string

Wymagane. Konto sprzedawcy, dla którego chcesz wyświetlić zasady zwrotów. Format: accounts/{account}

page_size

int32

Opcjonalnie. Maksymalna liczba zasobów (OnlineReturnPolicy) do zwrócenia. Usługa zwraca mniej niż ta wartość, jeśli liczba zasad zwrotów u danego sprzedawcy jest mniejsza niż pageSize. Wartością domyślną jest 10. Maksymalna wartość to 100. Jeśli podasz wartość wyższą niż wartość maksymalna, pageSize użyje wartości domyślnej

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListOnlineReturnPolicies. Aby pobrać kolejną stronę, podaj token strony.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListOnlineReturnPolicies muszą być zgodne z wywołaniem, które dostarczyło token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

ListOnlineReturnPoliciesResponse

Komunikat odpowiedzi dla metody ListOnlineReturnPolicies.

Pola
online_return_policies[]

OnlineReturnPolicy

Pobrane zasady zwrotów.

next_page_token

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListProgramsRequest

Komunikat żądania dla metody ListPrograms.

Pola
parent

string

Wymagane. Nazwa konta, z którego mają zostać pobrane wszystkie programy. Format: accounts/{account}

page_size

int32

Opcjonalnie. Maksymalna liczba programów, które zostaną zwrócone w pojedynczej odpowiedzi. Jeśli wartość nie jest określona (lub 0), używana jest wartość domyślna, czyli 1000. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token kontynuacji, odebrany z poprzedniego wywołania ListPrograms. Podaj je, aby pobrać następną stronę.

ListProgramsResponse

Komunikat odpowiedzi dla metody ListPrograms.

Pola
programs[]

Program

Programy dla danego konta.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListRegionsRequest

Komunikat żądania dla metody ListRegions.

Pola
parent

string

Wymagane. Konto, dla którego chcesz wyświetlić listę regionów. Format: accounts/{account}

page_size

int32

Opcjonalnie. Maksymalna liczba regionów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 50 regionów. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListRegions. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListRegions muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListRegionsResponse

Komunikat odpowiedzi dla metody ListRegions.

Pola
regions[]

Region

Regiony określonego sprzedawcy.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListSubAccountsRequest

Komunikat żądania dla metody ListSubAccounts.

Pola
provider

string

Wymagane. Konto nadrzędne. Format: accounts/{account}

page_size

int32

Opcjonalnie. Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 250 kont. Maksymalna wartość to 500. Wartości powyżej 500 zostaną zmienione na 500.

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListAccounts. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListAccounts muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListSubAccountsResponse

Komunikat odpowiedzi dla metody ListSubAccounts.

Pola
accounts[]

Account

Konta, w przypadku których dane konto nadrzędne jest pośrednikiem.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

ListUsersRequest

Komunikat żądania dla metody ListUsers.

Pola
parent

string

Wymagane. Podmiot nadrzędny, do którego należy ta kolekcja użytkowników. Format: `accounts/{konto}

page_size

int32

Opcjonalnie. Maksymalna liczba użytkowników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwrócony zostanie maksymalnie 50 użytkowników. Maksymalna wartość to 100; wartości powyżej 100 zostaną zmienione na 100

page_token

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania funkcji ListUsers. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu ListUsers muszą być zgodne z wywołaniem, które dostarczyło token strony.

ListUsersResponse

Komunikat odpowiedzi dla metody ListUsers.

Pola
users[]

User

Użytkownicy z określonego konta.

next_page_token

string

Token, który może zostać wysłany jako page_token w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

LocationIdSet

Lista zestawów identyfikatorów lokalizacji. Pole nie może być puste. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

Pola
location_ids[]

string

Wymagane. Niepusta lista identyfikatorów lokalizacji. Wszystkie lokalizacje muszą być tego samego typu (np. stan).

MinimumOrderValueTable

Tabela z minimalnymi wartościami zamówienia na sklep dla typu realizacji zamówienia z odbiorem.

Pola
store_code_set_with_movs[]

StoreCodeSetWithMov

Wymagane. Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia (MOV). Wymagane są co najmniej dwa zestawy, a ostatni musi być pusty, co oznacza „MOV dla wszystkich pozostałych sklepów”. Każdy kod sklepu może się wyświetlić tylko raz we wszystkich zestawach. Wszystkie ceny w ramach usługi muszą mieć tę samą walutę.

StoreCodeSetWithMov

Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia. Wymagane są co najmniej dwa zestawy, a ostatni musi być pusty, co oznacza „MOV dla wszystkich pozostałych sklepów”. Każdy kod sklepu może się wyświetlić tylko raz we wszystkich zestawach. Wszystkie ceny w ramach usługi muszą mieć tę samą walutę.

Pola
store_codes[]

string

Opcjonalnie. Lista unikalnych kodów sklepów lub pusta w przypadku kategorii typu „catch wszystko”.

value

Price

Minimalna wartość zamówienia w przypadku danych sklepów.

OnlineReturnPolicy

Obiekt zasady zwrotów online. Jest on obecnie używany do reprezentowania zasad zwrotów w przypadku reklam i programów bezpłatnych informacji.

Pola
name

string

Identyfikator. Nazwa zasobu OnlineReturnPolicy. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Tylko dane wyjściowe. Identyfikator zasad zwrotów wygenerowany przez Google.

label

string

To pole reprezentuje unikalną zdefiniowaną przez użytkownika etykietę zasad zwrotów. Pamiętaj, że tej samej etykiety nie można używać w różnych zasadach zwrotów w tym samym kraju. Jeśli w produkcie nie określono konkretnego atrybutu etykiety, zasady będą automatycznie oznaczane jako „domyślne”. Aby przypisać niestandardowe zasady zwrotów do określonych grup produktów, postępuj zgodnie z instrukcjami podanymi w artykule Etykieta zasad zwrotów. Etykieta może zawierać maksymalnie 50 znaków.

countries[]

string

Kraje sprzedaży, w których obowiązują zasady zwrotów. Wartości muszą być prawidłowym 2-literowym kodem ISO 3166.

policy

Policy

Zasady zwrotów.

restocking_fee

RestockingFee

Opłata za uzupełnienie towarów, która obowiązuje w przypadku wszystkich kategorii powodów zwrotu. Jeśli ta wartość nie zostanie ustawiona, będzie ona traktowana jako bezpłatna opłata za uzupełnienie towarów.

return_methods[]

ReturnMethod

Metody zwrotów dla klientów, którzy mogą zwrócić produkt. Ta wartość nie może być pusta, chyba że typem zasad zwrotów jest noReturns.

item_conditions[]

ItemCondition

Warunki akceptowane w przypadku zwrotów nie mogą być puste, chyba że typ zasad zwrotów to „noReturns”.

return_shipping_fee

ReturnShippingFee

Opłata za przesyłkę zwrotną. Należy go ustawić tylko wtedy, gdy klient musi pobrać i wydrukować etykietę zwrotną.

return_policy_uri

string

Identyfikator URI zasad zwrotów. Google może go użyć, aby sprawdzić poprawność zasad. Podaj prawidłowy URL.

accept_defective_only

bool

To pole określa, czy sprzedawca akceptuje tylko wadliwe produkty i że jest wymagane.

process_refund_days

int32

Pole określa liczbę dni potrzebnych sprzedawcom na przetworzenie zwrotu środków. Pole jest opcjonalne.

accept_exchange

bool

To pole określa, czy sprzedawca umożliwia klientom wymianę produktów. To pole jest wymagane.

ItemCondition

Dostępne warunki produktu.

Wartości w polu enum
ITEM_CONDITION_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NEW Nowość.
USED Użyto.

Zasady

dostępnych zasad,

Pola
type

Type

Typ zasady.

days

int64

W ciągu ilu dni od dostawy można zwrócić produkty, przy czym jeden dzień oznacza 24 godziny od sygnatury czasowej dostawy. Wymagany w przypadku zwrotów produktów NUMBER_OF_DAYS_AFTER_DELIVERY.

Typ

Typy zasad zwrotów.

Wartości w polu enum
TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NUMBER_OF_DAYS_AFTER_DELIVERY Liczba dni, w ciągu których zwrot jest ważny od momentu dostawy.
NO_RETURNS Bez możliwości zwrotu.
LIFETIME_RETURNS Zwrot całkowity.

RestockingFee

Opłata za uzupełnienie towarów. Może to być opłata stała lub mikroprocent.

Pola

Pole sumy type.

type może mieć tylko jedną z tych wartości:

fixed_fee

Price

Stała opłata za uzupełnienie towarów.

micro_percent

int32

Procent ceny całkowitej w milionowych częściach jednostki. 15 000 000 oznacza, że zostanie pobrana 15% całkowitej ceny.

ReturnMethod

Dostępne metody zwrotów.

Wartości w polu enum
RETURN_METHOD_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
BY_MAIL Zwrot pocztą.
IN_STORE Zwrot w sklepie.
AT_A_KIOSK Wróć do kiosku.

ReturnShippingFee

Opłata za przesyłkę zwrotną. Może to być opłata stała lub wartość logiczna wskazująca, że klient pokrywa rzeczywisty koszt dostawy.

Pola
type

Type

Typ opłaty za przesyłkę zwrotną.

fixed_fee

Price

Stała kwota opłaty za przesyłkę zwrotną. Ta wartość ma zastosowanie tylko wtedy, gdy typ to FIXED. Opłata za przesyłkę zwrotną będzie uznawana za bezpłatną, jeśli typ to FIXED, a ta wartość nie zostanie ustawiona.

Typ

Typy opłat za przesyłkę zwrotną.

Wartości w polu enum
TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
FIXED Opłata za przesyłkę zwrotną ma stałą wartość.
CUSTOMER_PAYING_ACTUAL_FEE Klienci zapłacą rzeczywistą opłatę za przesyłkę zwrotną.

PhoneVerificationState

Stan weryfikacji telefonicznej.

Wartości w polu enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
PHONE_VERIFICATION_STATE_VERIFIED Telefon jest zweryfikowany.
PHONE_VERIFICATION_STATE_UNVERIFIED Telefon jest niezweryfikowany

Program

Definiuje udział w danym programie na określonym koncie.

Programy zapewniają mechanizm dodawania funkcji do kont sprzedawców. Typowym przykładem jest program Bezpłatne informacje o produkcie, który umożliwia bezpłatne wyświetlanie produktów ze sklepu sprzedawcy w Google.

Pola
name

string

Identyfikator. Nazwa zasobu programu. Format: accounts/{account}/programs/{program}

documentation_uri

string

Tylko dane wyjściowe. Adres URL strony pomocy Merchant Center opisującej program.

state

State

Tylko dane wyjściowe. Stan konta w programie.

active_region_codes[]

string

Tylko dane wyjściowe. Regiony, w których konto aktywnie uczestniczy w programie. Aktywne regiony to te, w których spełnione są wszystkie wymagania programu dotyczące regionów.

Kody regionów są definiowane przez CLDR. Wybierz kraj, w którym program dotyczy tylko tego kraju, lub 001, jeśli program obowiązuje na całym świecie.

unmet_requirements[]

Requirement

Tylko dane wyjściowe. Wymagania, które nie zostały jeszcze spełnione na koncie, które mają wpływ na udział w programie.

Co musisz zrobić

Definiuje wymagania określone dla uczestnictwa w programie.

Pola
title

string

Tylko dane wyjściowe. Nazwa wymagania.

documentation_uri

string

Tylko dane wyjściowe. Adres URL strony pomocy opisującej wymaganie.

affected_region_codes[]

string

Tylko dane wyjściowe. Regiony, których dotyczy to wymaganie, nie są obecnie spełnione.

Kody regionów są definiowane przez CLDR. Wybierz kraj, w którym program dotyczy tylko tego kraju, lub 001, jeśli program obowiązuje na całym świecie.

Stan

Możliwe stany udziału w programie na koncie.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
NOT_ELIGIBLE Konto nie kwalifikuje się do udziału w programie.
ELIGIBLE Konto może brać udział w programie.
ENABLED Program jest włączony na koncie.

RateGroup

Definicje grup kosztów dostawy. Tylko ostatni plik może mieć pustą wartość applicable_shipping_labels, co oznacza „Wszystkie pozostałe”. Pozostałe pola applicable_shipping_labels nie mogą się nakładać.

Pola
applicable_shipping_labels[]

string

Wymagane. Lista etykiet wysyłki definiujących produkty, do których ma zastosowanie dana grupa stawek. To rozgraniczenie: aby grupa stawek została zastosowana, musi zostać dopasowana tylko jedna z etykiet. To pole może być puste tylko w przypadku ostatniej grupy stawek usługi.

subtables[]

Table

Opcjonalnie. Lista podtabel, do których odwołuje się main_table. Można go ustawić tylko wtedy, gdy ustawiono main_table.

carrier_rates[]

CarrierRate

Opcjonalnie. Lista stawek przewoźnika, do których można się odwołać w: main_table lub single_value.

single_value

Value

Wartość grupy stawek (np. stała opłata 10 USD). Można ją ustawić tylko wtedy, gdy nie są ustawione wartości main_table i subtables.

main_table

Table

Tabela określająca grupę stawek, gdy single_value nie jest wystarczająco ekspresyjny. Można go ustawić tylko wtedy, gdy zasada single_value nie jest skonfigurowana.

name

string

Opcjonalnie. Nazwa grupy stawek. Jeśli ustawiona wartość musi być niepowtarzalna w obrębie usługi dostawy.

Region

Reprezentuje region geograficzny, którego można używać jako celu w usługach RegionalInventory i ShippingSettings. Regiony możesz definiować jako zbiory kodów pocztowych lub, w niektórych krajach, za pomocą wstępnie zdefiniowanych celów geograficznych. Więcej informacji znajdziesz w artykule Konfigurowanie regionów .

Pola
name

string

Identyfikator. Nazwa zasobu regionu. Format: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

Opcjonalnie. Lista kodów pocztowych definiujących obszar regionu.

geotarget_area

GeoTargetArea

Opcjonalnie. Lista celów geograficznych definiujących obszar regionu.

regional_inventory_eligible

BoolValue

Tylko dane wyjściowe. Wskazuje, czy region kwalifikuje się do użycia w konfiguracji regionalnego asortymentu.

shipping_eligible

BoolValue

Tylko dane wyjściowe. Wskazuje, czy region kwalifikuje się do użycia w konfiguracji usług dostawy.

display_name

string

Opcjonalnie. Wyświetlana nazwa regionu.

GeoTargetArea

Lista celów geograficznych definiujących obszar regionu.

Pola
geotarget_criteria_ids[]

int64

Wymagane. Niepusta lista identyfikatorów lokalizacji. Wszystkie lokalizacje muszą być tego samego typu (np. stan).

PostalCodeArea

Lista kodów pocztowych definiujących obszar regionu. Uwaga: wszystkie regiony określone za pomocą kodów pocztowych są dostępne na koncie ShippingSettings.postalCodeGroups.

Pola
region_code

string

Wymagane. Kod regionu CLDR lub kraj, którego dotyczy dana grupa kodów pocztowych.

postal_codes[]

PostalCodeRange

Wymagane. Zakres kodów pocztowych.

PostalCodeRange

Zakres kodów pocztowych określający obszar regionu.

Pola
begin

string

Wymagane. Kod pocztowy lub wzorzec prefiksu formularza* wyznaczający dolną granicę zakresu definiującego obszar. Przykładowe wartości: 94108, 9410* oraz 9*.

end

string

Opcjonalnie. Kod pocztowy lub wzór postaci prefix* określający górną granicę zakresu definiującego obszar. Musi mieć taką samą długość jak adres pocztowyCodeRangePoczątek: jeśli to adres pocztowyCodeRangePoczątek to kod pocztowy, konieczną wartością kodu pocztowego KoniecZakresuDanu musi być też kod pocztowy. W przypadku wzorca początkowego zakresu_Kodupocztowego Początek musi być wzorcem o tej samej długości prefiksu. Opcjonalnie: jeśli nie zostanie ustawiony, obszar jest definiowany jako wszystkie kody pocztowe pasujące do pola identifierCodeRangeStart.

Wymagane

Opisuje warunki korzystania z usługi, które należy zaakceptować.

Pola
terms_of_service

string

termsOfService, które należy zaakceptować.

tos_file_uri

string

Pełny adres URL pliku z warunkami korzystania z usługi. To pole działa tak samo jak TermsOfService.file_uri, ale zostało tu dodane tylko dla wygody.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Komunikat żądania dla metody RetrieveForApplicationTermsOfServiceAgreementState.

Pola
parent

string

Wymagane. Konto, w przypadku którego ma zostać pobrany w tym formacie: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Komunikat żądania dla metody RetrieveLatestTermsOfService.

Pola
region_code

string

Kod regionu określony przez CLDR. Jest to kraj, w którym Warunki korzystania z usługi obowiązują w danym kraju, lub kod 001, jeśli obowiązują na całym świecie.

kind

TermsOfServiceKind

Rodzaj, którego dotyczy ta wersja warunków korzystania z usługi.

Wiersz

Uwzględnij listę komórek.

Pola
cells[]

Value

Wymagane. Lista komórek tworzących wiersz. Musi mieć taką samą długość jak columnHeaders w przypadku tabel dwuwymiarowych i 1 w przypadku tabel jednowymiarowych.

Usługa

Usługa dostawy.

Pola
delivery_countries[]

string

Wymagane. Kod regionu CLDR obowiązujący w przypadku krajów, w których usługa jest dostępna.

rate_groups[]

RateGroup

Opcjonalnie. Definicje grup kosztów dostawy. Tylko ostatni plik może mieć pustą wartość applicable_shipping_labels, co oznacza „Wszystkie pozostałe”. Pozostałe pola applicable_shipping_labels nie mogą się nakładać.

loyalty_programs[]

LoyaltyProgram

Opcjonalnie. Programy lojalnościowe, do których jest ograniczona ta usługa dostawy.

service_name

string

Wymagane. Swobodna nazwa usługi. Musi być niepowtarzalna w obrębie konta docelowego.

active

bool

Wymagane. Wartość logiczna pokazująca aktywny stan usługi dostawy.

currency_code

string

Kod CLDR waluty, do której odnosi się dana usługa. Musi odpowiadać cenom w grupach stawek.

delivery_time

DeliveryTime

Wymagane. Czas potrzebny na wykonanie różnych czynności – od złożenia zamówienia po dostarczenie produktu

shipment_type

ShipmentType

Typ lokalizacji, do których ta usługa wysyła zamówienia.

minimum_order_value

Price

Minimalna wartość zamówienia w przypadku tej usługi. Jeśli jest ustawiona, wskazuje, że klienci będą musieli wydać co najmniej tę kwotę. Wszystkie ceny w ramach usługi muszą mieć tę samą walutę. Nie można go ustawić razem z atrybutem minimum_order_value_table.

minimum_order_value_table

MinimumOrderValueTable

Tabela z minimalnymi wartościami zamówienia na sklep dla typu realizacji zamówienia z odbiorem. Nie można go ustawić razem z wartością minimum_order_value.

store_config

StoreConfig

Lista sklepów, z których są dostarczane Twoje produkty. Ta opcja dotyczy tylko dostawy lokalnej.

LoyaltyProgram

Program lojalnościowy oferowany przez sprzedawcę.

Pola
loyalty_program_tiers[]

LoyaltyProgramTiers

Opcjonalnie. Poziom programu lojalnościowego tej usługi dostawy.

program_label

string

Jest to etykieta programu lojalnościowego określona w ustawieniach programu lojalnościowego w Merchant Center. Ten atrybut podrzędny umożliwia Google powiązanie programu lojalnościowego z odpowiednimi ofertami.

LoyaltyProgramTiers

Podzbiór programu lojalnościowego sprzedawcy.

Pola
tier_label

string

Atrybut podrzędny etykieta poziomu [tier_label] różnicuje korzyści na poziomie oferty pomiędzy poszczególnymi poziomami. Ta wartość jest również określona w ustawieniach programu Merchant Center i jest wymagana do zmiany źródła danych, nawet jeśli Twój program lojalnościowy ma tylko 1 poziom.

ShipmentType

Typ dostawy w usłudze dostawy.

Wartości w polu enum
SHIPMENT_TYPE_UNSPECIFIED Ta usługa nie określała typu przesyłki.
DELIVERY Ta usługa wysyła zamówienia na adres wybrany przez klienta.
LOCAL_DELIVERY Ta usługa wysyła zamówienia na adres wybrany przez klienta. Zamówienie jest wysyłane z lokalnego sklepu w pobliżu.
COLLECTION_POINT Ta usługa wysyła zamówienia na adres wybrany przez klienta. Zamówienie jest wysyłane do punktu odbioru.

StoreConfig

Lista sklepów, z których są dostarczane Twoje produkty. Ta opcja dotyczy tylko dostawy lokalnej.

Pola
store_codes[]

string

Opcjonalnie. Lista kodów sklepów z dostawą lokalną. Jeśli pole jest puste, pole all_stores musi mieć wartość true (prawda).

store_service_type

StoreServiceType

Wskazuje, czy wszystkie lub wybrane sklepy wymienione przez tego sprzedawcę oferują dostawę lokalną.

cutoff_config

CutoffConfig

Konfiguracja związana z dostarczaniem lokalnym kończy się w danym dniu.

service_radius

Distance

Maksymalny promień dostawy. Jest to wymagane tylko w przypadku dostawy lokalnej.

CutoffConfig

Konfiguracja związana z dostarczaniem lokalnym kończy się w danym dniu.

Pola
local_cutoff_time

LocalCutoffTime

Godzina zakończenia dostawy lokalnej tego dnia.

store_close_offset_hours

int64

Dotyczy tylko realizacji dostawy lokalnej. Reprezentuje ostateczny termin jako liczbę godzin do zamknięcia sklepu. Wzajemnie wyklucza się z: local_cutoff_time.

no_delivery_post_cutoff

bool

Sprzedawcy mogą zrezygnować z wyświetlania lokalnej dostawy w ciągu n+1 dnia, jeśli mają usługę dostawy skonfigurowaną do n-dniowej dostawy lokalnej. Jeśli na przykład usługa dostawy definiuje dostawę tego samego dnia, a ten termin już minął, ustawienie tego pola na true spowoduje, że obliczona stawka za usługę dostawy będzie zwracana NO_DELIVERY_POST_CUTOFF. W tym samym przykładzie ustawienie tego pola na false powoduje, że obliczony czas dostawy wynosi 1 dzień. Dotyczy to tylko dostawy lokalnej.

LocalCutoffTime

Godzina zakończenia dostawy lokalnej tego dnia.

Pola
hour

int64

Zamówienia z dostawą lokalną muszą zostać złożone do tego dnia, aby mogły zostać przetworzone tego samego dnia.

minute

int64

Zamówienia minutowe z dostawą lokalną należy składać do, aby mogły zostać przetworzone tego samego dnia.

StoreServiceType

Wskazuje, czy wszystkie lub wybrane sklepy wymienione przez sprzedawcę oferują dostawę lokalną.

Wartości w polu enum
STORE_SERVICE_TYPE_UNSPECIFIED Nie określono typu usługi sklepu.
ALL_STORES Wskazuje, czy wszystkie sklepy (obecne i przyszłe) wymienione przez tego sprzedawcę oferują dostawę lokalną.
SELECTED_STORES Oznacza to, że dostawa lokalna jest dostępna tylko w sklepach wymienionych w tym regionie: store_codes.

ShippingSettings

[ustawienia dostawy](https://support.google.com/merchants/answer/6069284) na koncie sprzedawcy.

Pola
name

string

Identyfikator. Nazwa zasobu ustawienia dostawy. Format: accounts/{account}/shippingSetting

services[]

Service

Opcjonalnie. Lista usług na koncie docelowym.

warehouses[]

Warehouse

Opcjonalnie. Lista magazynów, do których można się odwołać w: services.

etag

string

Wymagane. To pole służy do uniknięcia problemu asynchronicznego. Upewnij się, że ustawienia dostawy nie zmieniły się między otrzymaniem połączenia a nawiązaniem połączenia. Użytkownik powinien wykonać te czynności:

  1. Ustaw pole etag jako pusty ciąg znaków podczas tworzenia początkowego ustawienia dostawy.

  2. Po początkowym utworzeniu wywołaj metodę get, aby uzyskać dane ETag i bieżące ustawienia dostawy przed wstawieniem wywołania.

  3. Zmodyfikuj informacje o ustawieniu dostawy.

  4. Metoda wstawiania wywołania z informacjami o wymaganych ustawieniach dostawy za pomocą parametru etag uzyskanego w kroku 2.

  5. Jeśli dane ustawienia dostawy zostały zmienione między krokami 2 a 4. Żądanie wstawiania nie powiedzie się, ponieważ eTag zmienia się za każdym razem, gdy zmienia się dane ustawienia dostawy. Użytkownik powinien powtórzyć kroki 2–4, dodając nowy tag.

Tabela

Tabela określająca grupę stawek, gdy single_value nie jest wystarczająco ekspresyjny.

Pola
rows[]

Row

Wymagane. Lista wierszy tworzących tabelę. Musi mieć taką samą długość jak row_headers.

name

string

Nazwa tabeli. Wymagane w przypadku podtabel, ignorowane w przypadku głównej tabeli.

row_headers

Headers

Wymagane. Nagłówki wierszy w tabeli.

column_headers

Headers

Nagłówki kolumn tabeli. Opcjonalnie: jeśli zasada nie jest skonfigurowana, tabela zawiera tylko 1 wymiar.

TaxRule

Konwencja podstawowego typu

procent mikro : 100% = 1 000 000 i 1% = 10 000 nie może być wartością ujemną.

Informacje o zakładzie podatkowym i powiązanych parametrach dotyczących zamówień dostarczanych do obszaru obsługiwanego przez jednego administratora podatkowego. Nexus jest tworzony, gdy sprzedawca prowadzi działalność na obszarze, którym administruje administrator podatkowy (konfiguracja zakładu zagranicznego jest obsługiwana tylko w stanach USA). Jeśli sprzedawca ma zagraniczny zakład w stanie USA, musi zapłacić podatek wszystkim urzędom podatkowym powiązanym z miejscem dostawy. Następny identyfikator : 8

Pola
region_code

string

Kod regionu, w którym obowiązuje ta reguła

shipping_taxed

bool

Jeśli zasada jest skonfigurowana, opłata za dostawę jest opodatkowana (taką samą jak w przypadku produktu) w przypadku dostawy do obszaru administracyjnego. Można go ustawić tylko dla stanów w USA bez kategorii.

effective_time_period

Interval

Wymagane. Okres, przez jaki ta reguła jest stosowana. Jeśli czasu trwania nie ma w podanej wartości w polu „effective_time”, oznacza to, że jest otwarta na przyszłość. Początek tego okresu uwzględnia czas, a koniec nie.

Pole sumy location. Opisz lokalizację za pomocą zakresu kodów pocztowych lub identyfikatora kryteriów. location może mieć tylko jedną z tych wartości:
location_id

int64

Identyfikator administratora lub kryterium_id regionu, w którym obowiązuje ta reguła.

post_code_range

TaxPostalCodeRange

Zakres kodów pocztowych, do których ma zastosowanie ta reguła.

Pole sumy rate_calculation. W jaki sposób obliczyć stawkę podatku za dostawy do obszaru, na którym jest ten administrator. Można go ustawić tylko dla stanów w USA. rate_calculation może mieć tylko jedną z tych wartości:
use_google_rate

bool

Stawka zależna od miejsca dostawy: jeśli sprzedawca ma zakład zagraniczny w odpowiednim stanie w Stanach Zjednoczonych, stawki urzędów właściwym dla obszaru dostawy są sumowane.

self_specified_rate_micros

int64

Stała stawka podana w mikro, gdzie 100% = 1_000_000. Odpowiedni dla stanów uwzględniających miejsce pochodzenia.

TaxPostalCodeRange

Zakres kodów pocztowych określający obszar.

Pola
start

string

Wymagane. Początek zakresu kodów pocztowych, który jest również najmniejszy w zakresie.

end

string

Koniec zakresu kodów pocztowych. Będzie taka sama jak początek, jeśli nie zostanie określona.

TermsOfService

TermsOfService.

Pola
name

string

Identyfikator. Nazwa zasobu wersji warunków korzystania z usługi. Format: termsOfService/{version}

region_code

string

Kod regionu określony przez CLDR. Wybierz kraj, w którym Warunki korzystania z usługi obowiązują konkretnie w tym kraju, lub 001, jeśli w dowolnym kraju można zalogować się w tym samym kraju (TermsOfService). Pamiętaj jednak, że podpisując Warunki korzystania z usługi obowiązujące globalnie, nadal oczekujemy podania konkretnego kraju (powinien to być kraj prowadzenia działalności przez sprzedawcę lub kraj udziału w programie).

kind

TermsOfServiceKind

Rodzaj, którego dotyczy ta wersja warunków korzystania z usługi.

external

bool

Określa, czy ta wersja warunków korzystania z usługi jest zewnętrzna. Zewnętrzne wersje warunków korzystania z usługi można uzgodnić wyłącznie w ramach procesów zewnętrznych, a nie bezpośrednio przez sprzedawcę za pomocą interfejsu użytkownika lub interfejsu API.

file_uri

string

Identyfikator URI pliku z warunkami korzystania z usługi, który musi być wyświetlany użytkownikom podpisującym.

TermsOfServiceAgreementState

Ten zasób reprezentuje stan umowy dla danego konta i rodzaju warunków korzystania z usługi. Oto stan:

  • Jeśli sprzedawca zaakceptował warunki korzystania z usługi: pole accepted jest wypełnione. W przeciwnym razie pole jest puste.
  • Jeśli sprzedawca musi zaakceptować warunki korzystania z usługi: pole required będzie wypełnione. W przeciwnym razie pole będzie puste.

Pamiętaj, że mogą znajdować się zarówno wartości wymagane, jak i akceptowane. W tym przypadku warunki korzystania z usługi accepted będą miały datę ważności w polu valid_until. Aby konto nadal było ważne, musisz zaakceptować warunki korzystania z usługi required przed valid_until. Podczas akceptowania nowych warunków korzystania z usługi oczekujemy, że firmy zewnętrzne wyświetlą tekst powiązany z poszczególnymi warunkami korzystania z usługi (adres URL pliku zawierającego ten tekst jest dodawany w polu „Wymagane” poniżej jako tos_file_uri). Zaakceptowanie warunków korzystania z usługi jest możliwe przez wywołanie metody „Akceptuję” w zasobie TermsOfService.

Pola
name

string

Identyfikator. Nazwa zasobu wersji warunków korzystania z usługi. Format: accounts/{account}/termsOfServiceAgreementState/{identifier}

region_code

string

Kod regionu określony na stronie https://cldr.unicode.org/. Jest to kraj, którego dotyczy bieżący stan.

terms_of_service_kind

TermsOfServiceKind

Rodzaj Warunków korzystania z usługi powiązany z konkretną wersją.

accepted

Accepted

Akceptowane warunki korzystania z tego rodzaju usługi oraz powiązany kod regionu

required

Required

Wymagane warunki korzystania z usługi

TermsOfServiceKind

Warunki korzystania z usługi.

Wartości w polu enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MERCHANT_CENTER Aplikacja Merchant Center.

TransitTable

Tabela czasu przewozu, liczba dni roboczych podczas przesyłania na podstawie wymiarów wierszy i kolumn. Można ustawić jedną z tych wartości: min_transit_days, max_transit_days lub transit_time_table, ale nie oba jednocześnie.

Pola
postal_code_group_names[]

string

Wymagane. Lista nazw regionów Region.name . Ostatnia wartość może wynosić "all other locations". Przykład: ["zone 1", "zone 2", "all other locations"]. Podane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi.

transit_time_labels[]

string

Wymagane. Lista etykiet czasu przewozu. Ostatnia wartość może wynosić "all other labels". Przykład: ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Wymagane. Jeśli występuje tylko 1 zbiór wymiarów o wartości postal_code_group_names lub transit_time_labels, będzie dostępnych wiele wierszy zawierających po jednej wartości dla tego wymiaru. Jeśli dostępne są 2 wymiary, każdy wiersz odpowiada kolumnie postal_code_group_names, a kolumny (wartości) – transit_time_labels.

TransitTimeRow

Jeśli występuje tylko 1 zbiór wymiarów o wartości postal_code_group_names lub transit_time_labels, będzie dostępnych wiele wierszy zawierających po jednej wartości dla tego wymiaru. Jeśli dostępne są 2 wymiary, każdy wiersz odpowiada kolumnie postal_code_group_names, a kolumny (wartości) – transit_time_labels.

Pola
values[]

TransitTimeValue

Wymagane. Zakres czasu przewozu (min.–maks.) w dniach roboczych.

TransitTimeValue

Zakres czasu przewozu (min.–maks.) w dniach roboczych.

Pola
min_transit_days

int32

Minimalny zakres czasu przewozu w dniach roboczych. 0 oznacza dostawę tego samego dnia, 1 oznacza dostawę następnego dnia.

max_transit_days

int32

Wartość nie może być mniejsza niż min_transit_days.

UnclaimHomepageRequest

Komunikat żądania dla metody UnclaimHomepage.

Pola
name

string

Wymagane. Nazwa strony głównej, do której chcesz usunąć prawa. Format: accounts/{account}/homepage

UpdateAccountRequest

Komunikat żądania dla metody UpdateAccount.

Pola
account

Account

Wymagane. Nowa wersja konta.

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

UpdateAccountTaxRequest

Prośba o zaktualizowanie ustawień podatków

Pola
account_tax

AccountTax

Wymagane. Ustawienie podatku, które zostanie zaktualizowane

update_mask

FieldMask

Lista pól do zaktualizowania

UpdateBusinessIdentityRequest

Komunikat żądania dla metody UpdateBusinessIdentity.

Pola
business_identity

BusinessIdentity

Wymagane. Nowa wersja tożsamości firmy.

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

UpdateBusinessInfoRequest

Komunikat żądania dla metody UpdateBusinessInfo.

Pola
business_info

BusinessInfo

Wymagane. Nowa wersja informacji o firmie.

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

UpdateEmailPreferencesRequest

Prośba o wiadomość dotyczącą metody UpdateEmailPreferences.

Pola
email_preferences

EmailPreferences

Wymagane. Ustawienia powiadomień e-mail, które zostaną zaktualizowane.

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

UpdateHomepageRequest

Komunikat żądania dla metody UpdateHomepage.

Pola
homepage

Homepage

Wymagane. Nowa wersja strony głównej.

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

UpdateRegionRequest

Komunikat żądania dla metody UpdateRegion.

Pola
region

Region

Wymagane. Zaktualizowany region.

update_mask

FieldMask

Opcjonalnie. Rozdzielona przecinkami maska pola wskazująca pola do zaktualizowania. Przykład: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Komunikat żądania dla metody UpdateUser.

Pola
user

User

Wymagane. Nowa wersja konta użytkownika.

Możesz też zaktualizować użytkownika powiązanego z rozmówcą, używając pola me zamiast adresu e-mail w polu nazwy (jak w zasadzie accounts/{account}/users/me).

update_mask

FieldMask

Wymagane. Lista aktualizowanych pól.

Użytkownik

Użytkownik.

Pola
name

string

Identyfikator. Nazwa zasobu użytkownika. Format: accounts/{account}/user/{user}

state

State

Tylko dane wyjściowe. Stan użytkownika.

access_rights[]

AccessRight

Opcjonalnie. Uprawnienia użytkownika.

Stan

Możliwe stany użytkownika.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
PENDING Użytkownik czeka na potwierdzenie. W takiej sytuacji użytkownik musi najpierw zaakceptować zaproszenie, aby móc wykonać inne działania.
VERIFIED Użytkownik jest zweryfikowany.

Wartość

Pojedyncza wartość grupy stawek lub wartość komórki tabeli grupy stawek. Należy ustawić tylko jedną z tych wartości: no_shipping, flat_rate, price_percentage, carrier_rateName lub subtable_name.

Pola
no_shipping

bool

Jeśli ma wartość prawda, nie można wysłać produktu. Ta wartość musi mieć wartość true (prawda) i można ją ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

flat_rate

Price

Płaska stawka. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

price_percentage

string

Wartość procentowa ceny wyrażona w notacji dziesiętnej (np. "5.4"). Można ją ustawić tylko wtedy, gdy nie ustawiono wszystkich pozostałych pól.

carrier_rate

string

Nazwa stawki przewoźnika odnoszącej się do stawki przewoźnika zdefiniowanej w tej samej grupie stawek. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól.

subtable

string

Nazwa podtabeli. Można go ustawić tylko w komórkach tabeli (np. nie dla pojedynczych wartości) i tylko wtedy, gdy nie ustawiono wszystkich innych pól.

Magazyn

Magazyn realizacji zamówień, który przechowuje i obsługuje asortyment. Następny tag: 7

Pola
name

string

Wymagane. Nazwa magazynu. Musi być niepowtarzalny w obrębie konta.

shipping_address

Address

Wymagane. Adres dostawy magazynu.

cutoff_time

WarehouseCutoffTime

Wymagane. Najwyższa pora dnia, o której można zaakceptować zamówienie i rozpocząć jego przetwarzanie. Późniejsze zamówienia zostaną przetworzone następnego dnia. Zależy to od kodu pocztowego magazynu.

handling_days

int64

Wymagane. Liczba dni potrzebnych na spakowanie i wysłanie produktu w tym magazynie. Jest ona na poziomie magazynu, ale można ją zastąpić na poziomie oferty na podstawie atrybutów produktu.

business_day_config

BusinessDayConfig

Dni robocze w magazynie. Jeśli zasada nie jest skonfigurowana, od poniedziałku do piątku.

WarehouseBasedDeliveryTime

Informuje, że czas dostawy powinien być obliczany dla poszczególnych magazynów (lokalizacji wysyłki) na podstawie ustawień wybranego przewoźnika. Jeśli zasada jest skonfigurowana, w delivery_time nie należy ustawiać żadnych innych pól związanych z czasem przewozu.

Pola
carrier

string

Wymagane. Operator, na przykład "UPS" lub "Fedex".

carrier_service

string

Wymagane. Usługa przewoźnika, na przykład "ground" lub "2 days". Nazwa usługi musi być na liście eddSupportedServices.

warehouse

string

Wymagane. Nazwa magazynu. Te dane powinny być takie same jak [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

Najwyższa pora dnia, o której można zaakceptować zamówienie i rozpocząć jego przetwarzanie. Późniejsze zamówienia zostaną przetworzone następnego dnia. Zależy to od kodu pocztowego magazynu.

Pola
hour

int32

Wymagane. Godzina, do której należy złożyć zamówienie, aby mogło zostać przetworzone tego samego dnia przez magazyn. Godzina zależy od strefy czasowej magazynu.

minute

int32

Wymagane. Minuta ostatecznych terminów, do których zamówienie musi zostać złożone, aby zostało przetworzone tego samego dnia przez magazyn. Minuta zależy od strefy czasowej magazynu.