Package google.shopping.merchant.accounts.v1beta

string

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

string

Wymagane. Konto, na którym chcesz zaakceptować Warunki korzystania z usługi.

string

Wymagane. Kod regionu według CLDR. Jest to kod kraju, jeśli warunki korzystania z usługi mają zastosowanie tylko w danym kraju, lub 001, jeśli mają zastosowanie na całym świecie.

string

Zaakceptowane termsOfService.

string

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

Date

Jeśli jest ustawiona, oznacza, że zaakceptowane TermsOfService są ważne tylko do końca tej daty (w czasie UTC). Do tego czasu musisz zaakceptować nowy. Informacje o wymaganych TermsOfService można znaleźć w wiadomości Wymagane.

string

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

int64

Tylko dane wyjściowe. Identyfikator konta.

string

Wymagane. Zrozumiała dla człowieka nazwa konta. Więcej informacji znajdziesz w artykułach na temat nazwy sklepu i nazwy firmy.

bool

Czy to konto zawiera treści dla dorosłych.

bool

Tylko dane wyjściowe. Czy to jest konto testowe.

TimeZone

Wymagane. Strefa czasowa konta.

Podczas zapisu time_zone ustawia zarówno reporting_time_zone, jak i display_time_zone.

W przypadku odczytów time_zone zawsze zwraca display_time_zone. Jeśli na Twoim koncie nie ma elementu display_time_zone, element time_zone jest pusty.

string

Wymagane. Kod języka BCP-47 konta, np. en-US lub sr-Latn.

string

Identyfikator. Nazwa zasobu problemu z kontem. Format: accounts/{account}/issues/{id}

string

Zlokalizowany tytuł problemu.

Severity

Ogólny stopień ważności problemu.

ImpactedDestination

wpływ tego problemu na różne miejsca docelowe;

string

dodatkowe zlokalizowane informacje o problemie;

string

Link do Centrum pomocy Merchant Center, w którym znajdziesz więcej informacji o problemie i sposobach jego rozwiązania.

Impact

(Negatywny) wpływ różnych regionów na dany cel.

ReportingContextEnum

Kontekst raportowania, którego dotyczy problem.

string

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

Severity

Poważniejszą usterkę w przypadku docelowego miejsca docelowego i regionu.

string

Ulica i numer w adresie. Na przykład: 111w 31st Street.

string

Wymagane. Miasto, miasteczko lub gmina. Mogą również obejmować miejscowości podrzędne lub podmiejskie (np. dzielnice lub przedmieścia).

string

Wymagane. Najwyższy poziom podziału administracyjnego kraju. Może to być np. stan Kalifornia („CA”) lub prowincja Quebec („QC”).

string

Wymagane. Kod pocztowy (np. 94043).

string

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

string

Identyfikator. Nazwa zasobu ustawień pliku automatycznego. Format: accounts/{account}/autofeedSettings.

bool

Wymagane. Włącza lub wyłącza indeksowanie produktów przez automatyczny plik danych na danym koncie. Konta automatycznego wypełniania muszą spełniać określone warunki, które można sprawdzić w polu eligible. Konto nie może być platformą handlową. Gdy automatyczne przesyłanie danych jest włączone po raz pierwszy, produkty zwykle pojawiają się natychmiast. Gdy ponownie włączysz funkcję, może minąć do 24 godzin, zanim produkty pojawią się w Google.

bool

Tylko dane wyjściowe. Określa, czy sprzedawca kwalifikuje się do rejestracji w autofeedzie.

Weekday

Wymagane. Standardowe dni robocze. Nie może być pusta.

string

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

PromotionsConsent

Wymagane. Określa, czy atrybuty tożsamości mogą być używane do promocji.

IdentityAttribute

Opcjonalnie: Określa, czy firma twierdzi, że należy do osoby czarnoskórej. To opcjonalne pole będzie dostępne tylko dla sprzedawców, którzy mają ustawiony kraj działalności: US. Nie dotyczy ona również platform handlowych ani sprzedawców na tych platformach.

IdentityAttribute

Opcjonalnie: Określa, czy firma prezentuje się jako firma należąca do kobiety. To opcjonalne pole będzie dostępne tylko dla sprzedawców, którzy mają ustawiony kraj działalności: US. Nie dotyczy ona również platform handlowych ani sprzedawców na tych platformach.

IdentityAttribute

Opcjonalnie: Określa, czy firma twierdzi, że należy do weterana. To opcjonalne pole będzie dostępne tylko dla sprzedawców, którzy mają ustawiony kraj działalności: US. Nie dotyczy ona również platform handlowych ani sprzedawców na tych platformach.

IdentityAttribute

Opcjonalnie: Określa, czy firma określa się jako należąca do osoby pochodzenia latynoskiego. To opcjonalne pole będzie dostępne tylko dla sprzedawców, którzy mają ustawiony kraj działalności: US. Nie dotyczy ona również platform handlowych ani sprzedawców na tych platformach.

IdentityAttribute

Opcjonalnie: Określa, czy firma określa się jako mała firma. To opcjonalne pole będzie dostępne tylko dla sprzedawców, którzy mają ustawiony kraj działalności: US. Nie dotyczy to również platform handlowych.

IdentityDeclaration

Wymagane. Deklaracja tożsamości tego atrybutu.

string

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

PostalAddress

Opcjonalnie: adres firmy. Obsługiwane są tylko pola region_code, address_lines, postal_code, administrative_area i locality. Pozostałe pola są ignorowane.

PhoneNumber

Tylko dane wyjściowe. numer telefonu firmy;

PhoneVerificationState

Tylko dane wyjściowe. Stan weryfikacji numeru telefonu firmy.

CustomerService

Opcjonalnie: Obsługa klienta firmy.

string

Opcjonalnie: 10-cyfrowy koreański numer rejestracyjny firmy oddzielony myślnikami w formacie: XXX-XX-XXXXX.

string

Wymagane. Nazwa stawki przewoźnika. Musi być unikalny w przypadku każdej grupy stawek.

string

Wymagane. Usługa operatora, np. "UPS" lub "Fedex".

string

Wymagane. Usługa operatora, np. "ground" lub "2 days".

string

Wymagane. Miejsce nadania przesyłki dla tego przewoźnika.

string

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

Price

Opcjonalnie: Dodatni modyfikator stawki dostawy. Może być ujemna. Na przykład { "amount_micros": 1, "currency_code" : "USD" } zwiększa stawkę o 1 zł, a { "amount_micros": -3, "currency_code" : "USD" } zmniejsza ją o 3 zł.

string

Wymagane. Nazwa strony głównej, której dotyczy roszczenie. Format: accounts/{account}/homepage

bool

Opcjonalnie: Gdy ta opcja jest ustawiona na wartość true, usuwa ona wszystkie istniejące roszczenia dotyczące żądanej witryny i zastępuje je roszczeniem z konta, które wysłało żądanie.

Account

Wymagane. Konto, które ma zostać utworzone.

CreateUserRequest

Opcjonalnie: Użytkownicy, którzy mają zostać dodani do konta.

To pole zostało wycofane i nie będzie dostępne po tym, jak interfejs API przejdzie z wersji beta do wersji stabilnej. Zamiast tego użyj pola user.

AddUser

Opcjonalnie: Użytkownicy, którzy mają zostać dodani do konta.

AddAccountService

Wymagane. W ramach procesu tworzenia inicjowane jest konto usługi między tworzonym kontem a kontem dostawcy. Musisz podać co najmniej 1 taką usługę. Obecnie dokładnie 1 z nich musi być account_aggregation, co oznacza, że za pomocą tej metody możesz tworzyć tylko subkonta, a nie samodzielne konta. Mogą być dostępne dodatkowe usługi account_management lub product_management.

AccountAggregation

Dostawca jest agregatorem konta. Dane dotyczące usługi typu Agregacja kont

string

Wymagane. Dostawca usługi. Odwoływanie się do konta, np. providers/123, lub znanego usługodawcy (providers/GOOGLE_ADS lub providers/GOOGLE_BUSINESS_PROFILE).

string

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

User

Opcjonalnie: Szczegóły użytkownika, którego chcesz dodać. Obecnie można określić tylko prawa dostępu.

string

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

string

Wymagane. Identyfikator regionu, który jest niepowtarzalny w przypadku wszystkich regionów na tym samym koncie.

Region

Wymagane. Region, który chcesz utworzyć.

string

Wymagane. Nazwa zasobu na koncie, dla którego ma zostać utworzony użytkownik. Format: accounts/{account}

string

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

User

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

string

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

string

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

PhoneNumber

Opcjonalnie: Numer telefonu, pod którym można skontaktować się z obsługą klienta.

int32

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

int32

Wymagane. Minuta ostatecznego terminu, do którego należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia.

string

Wymagane. Identyfikator strefy czasowej, np. „Europe/Zurich”.

string

Wymagane. Nazwa konta, które chcesz usunąć. Format: accounts/{account}

bool

Opcjonalnie: Jeśli ustawisz wartość true, konto zostanie usunięte, nawet jeśli świadczy usługi dla innych kont lub przetworzy oferty.

string

Wymagane. Nazwa regionu, który chcesz usunąć. Format: accounts/{account}/regions/{region}

string

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

Użytkownik odpowiadający dzwoniącemu może też zostać usunięty, jeśli zamiast adresu e-mail (jak w przypadku accounts/{account}/users/me) użyjesz wartości me.

WarehouseBasedDeliveryTime

Opcjonalnie: Wskazuje, że czas dostawy powinien być obliczany dla każdego magazynu (miejsca nadania przesyłki) na podstawie ustawień wybranego przewoźnika. Jeśli to pole jest ustawione, żadne inne pole związane z czasem dostawy w [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] nie powinno być ustawione.

int32

Minimalna liczba dni roboczych, które mijają podczas transportu. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia. Musisz ustawić wartość min_transit_days, max_transit_days lub transit_time_table, ale nie obie.

int32

Maksymalna liczba dni roboczych na czas przewozu. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia. Musi być równa lub większa niż min_transit_days.

CutoffTime

Definicja czasu granicznej dostawy w dni robocze. Jeśli nie skonfigurujesz tego ustawienia, domyślnie będzie to godzina 8:00 czasu PST.

int32

Minimalna liczba dni roboczych przed wysłaniem zamówienia. 0 oznacza wysyłkę tego samego dnia, 1 oznacza wysyłkę następnego dnia. Parametry „min_handling_days” i „max_handling_days” powinny być ustawione lub nie ustawione w tym samym czasie.

int32

Maksymalna liczba dni roboczych przed wysłaniem zamówienia. 0 oznacza wysyłkę tego samego dnia, 1 oznacza wysyłkę następnego dnia. Musi być równa lub większa niż min_handling_days. Parametry „min_handling_days” i „max_handling_days” powinny być ustawione lub nie ustawione w tym samym czasie.

TransitTable

Tabela Czas przewozu, liczba dni roboczych spędzonych w transporcie na podstawie wymiarów wiersza i kolumny. Możesz ustawić wartość min_transit_days, max_transit_days lub transit_time_table, ale nie obie.

BusinessDayConfig

Dni robocze, w których można realizować zamówienia. Jeśli nie podasz tej informacji, przyjmiemy, że godziny pracy to od poniedziałku do piątku.

BusinessDayConfig

Dni robocze, w których zamówienia mogą być w drodze. Jeśli nie podasz tej informacji, przyjmiemy, że godziny pracy to od poniedziałku do piątku.

string

Wymagane. Nazwa programu, w którym chcesz wyłączyć udział danego konta. Format: accounts/{account}/programs/{program}

int64

Wartość całkowita odległości.

Unit

Jednostka może się różnić w zależności od kraju. Jest ona parametryzowana tak, aby uwzględniać mile i kilometry.

string

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

OptInState

Opcjonalnie: Aktualne informacje o nowych funkcjach, wskazówkach i sprawdzonych metodach.

string

Wymagane. Nazwa programu, w którym chcesz włączyć udział danego konta. Format: accounts/{account}/programs/{program}

string

Wymagane. Nazwa konta, które chcesz pobrać. Format: accounts/{account}

string

Wymagane. Nazwa zasobu ustawień pliku automatycznego. Format: accounts/{account}/autofeedSettings

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Wymagane. Nazwa użytkownika, którego dane mają zostać pobrane. Format: accounts/{account}/users/{email}

Można też pobrać użytkownika odpowiadającego dzwoniącemu, używając wartości me zamiast adresu e-mail, jak w przypadku accounts/{account}/users/me.

Price

Wymagane. Lista górnych granic cen zamówień z wliczonym podatkiem. Wartość ostatniej ceny może być nieskończona, jeśli ustawisz parametr price amount_micros = -1. Na przykład [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] oznacza nagłówki „<= 10 zł”, „<= 500 zł” i „> 500 zł”. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie. Nie może być puste. Musi być dodatni, z wyjątkiem wartości -1. Można go ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

Weight

Wymagane. Lista górnych granic wag zamówienia włącznie. Wartość ostatniego czynnika może być nieskończona, jeśli ustawisz parametr price 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 „> 50kg”. Wszystkie wagi w ramach usługi muszą mieć tę samą jednostkę. Nie może być puste. Musi być dodatni, z wyjątkiem wartości -1. Można go ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

string

Wymagane. Lista górnych granic liczby elementów. Ostatnia wartość może być "infinity". Na przykład ["10", "50", "infinity"] reprezentuje nagłówki „<= 10 elementów”, „<= 50 elementów” i „> 50 elementów”. Nie może być puste. Można go ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

string

Wymagane. Lista nazw grup pocztowych. Ostatnia wartość może być "all other locations". Przykład: ["zone 1", "zone 2", "all other locations"]. Wskazywane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi. Nie może być puste. Można go ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

LocationIdSet

Wymagane. Lista zestawów identyfikatorów lokalizacji. Nie może być puste. Można je ustawić tylko wtedy, gdy nie są ustawione żadne inne pola.

string

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

bool

Tylko dane wyjściowe. Czy strona główna jest zgłoszona. Zapoznaj się z artykułem https://support.google.com/merchants/answer/176793.

string

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

string

Wymagane. Konto, na którym zostanie wstawiony produkt. Format: accounts/{account}

ShippingSettings

Wymagane. Nowa wersja konta.

string

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

int32

Opcjonalnie: Maksymalna liczba problemów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 50 użytkowników. Maksymalna wartość to 100. Wartości powyżej 100 zostaną sformatowane na 100.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListAccountIssues muszą być zgodne z wywołaniem, które dostarczyło token strony.

string

Opcjonalnie: Problemy w odpowiedzi będą zawierać czytelne pola w danym języku. Format BCP-47, np. en-US lub sr-Latn. Jeśli nie podasz żadnej wartości, zostanie użyta wartość en-US.

string

Opcjonalnie: Strefa czasowa IANA używana do lokalizacji czasu w czytelnych dla człowieka polach. Na przykład „Ameryka/Los_Angeles”. Jeśli nie zostanie ustawiona, używana będzie strefa czasowa „America/Los_Angeles”.

AccountIssue

Problemy na określonym koncie.

string

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

int32

Opcjonalnie: Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 250 kont. Maksymalna wartość to 500. Wartości powyżej 500 są przymusowo ustawiane na 500.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListAccounts muszą być zgodne z wywołaniem, które dostarczyło token strony.

string

Opcjonalnie: Zwraca tylko konta, które pasują do filtra. Więcej informacji znajdziesz w dokumentacji dotyczącej składni filtrów.

Account

Konta pasujące do ListAccountsRequest.

string

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

string

Wymagane. Konto sprzedawcy, dla którego mają być wyświetlane zasady zwrotów. Format: accounts/{account}

int32

Opcjonalnie: Maksymalna liczba zwracanych zasobów OnlineReturnPolicy. Jeśli liczba zasad zwrotu danego sprzedawcy jest mniejsza niż pageSize, usługa zwraca mniejszą wartość. Wartością domyślną jest 10. Maksymalna wartość to 100. Jeśli zostanie podana wyższa wartość, pageSize zostanie domyślnie ustawiona na maksymalną.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListOnlineReturnPolicies muszą być zgodne z wywołaniem, które dostarczyło token strony. Token zwrócony jako nextPageToken w odpowiedzi na poprzednie żądanie.

OnlineReturnPolicy

Pobrane zasady zwrotów.

string

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

string

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

int32

Opcjonalnie: Maksymalna liczba programów do zwrócenia w jednej odpowiedzi. Jeśli nie zostanie podany rozmiar (lub 0), zostanie użyty domyślny rozmiar 1000. Maksymalna wartość to 1000; wartości powyżej 1000 zostaną skonwertowane na 1000.

string

Opcjonalnie: Token kontynuacji otrzymany z poprzedniego wywołania ListPrograms. Podaj ten parametr, aby pobrać kolejną stronę.

Program

Programy na danym koncie.

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

string

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

int32

Opcjonalnie: Maksymalna liczba regionów do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie zostanie podany, zwróci się maksymalnie 50 regionów. Maksymalna wartość to 1000; wartości powyżej 1000 zostaną skonwertowane na 1000.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListRegions muszą być zgodne z wywołaniem, które dostarczyło token strony.

Region

Regiony określonego sprzedawcy.

string

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

string

Wymagane. dostawca usługi agregacji; Format: providers/{providerId}

int32

Opcjonalnie: Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 250 kont. Maksymalna wartość to 500. Wartości powyżej 500 są przymusowo ustawiane na 500.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListAccounts muszą być zgodne z wywołaniem, które dostarczyło token strony.

Account

Konta, dla których dane konto nadrzędne jest agregatorem.

string

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

string

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

int32

Opcjonalnie: Maksymalna liczba użytkowników do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 50 użytkowników. Maksymalna wartość to 100. Wartości powyżej 100 zostaną sformatowane na 100.

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji ListUsers muszą być zgodne z wywołaniem, które dostarczyło token strony.

User

Użytkownicy z wybranego konta.

string

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

string

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

StoreCodeSetWithMov

Wymagane. Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia (MOV). Wymagane są co najmniej 2 zestawy, a ostatnia musi być pusta, co oznacza „MOV dla wszystkich pozostałych sklepów”. Każdy kod sklepu może wystąpić tylko raz we wszystkich zestawach. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie.

string

Opcjonalnie: Lista unikalnych kodów sklepów lub pusta lista dla wszystkich sklepów.

Price

Minimalna wartość zamówienia w danych sklepach.

string

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

string

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

string

Wymagane. Niezmienna. To pole to unikalna etykieta zdefiniowana przez użytkownika dla 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 produkt nie określa 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 sekcji Etykieta zasad zwrotów. Etykieta może zawierać maksymalnie 50 znaków.

string

Wymagane. Niezmienna. Kraje, w których obowiązują zasady zwrotów. Wartości muszą być prawidłowe 2-literowe kody ISO 3166.

Policy

Zasady zwrotów.

SeasonalOverride

Opcjonalnie: Dostosowania do ogólnych zasad dotyczących zamówień składanych w określonych przedziałach czasu.

RestockingFee

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

ReturnMethod

Metody zwrotu, których mogą używać klienci. Ta wartość nie może być pusta, chyba że typ zasady zwrotów to noReturns.

ItemCondition

Warunki zwrotu produktu nie mogą być puste, chyba że typ zasad zwrotów to „Bez zwrotów”.

ReturnShippingFee

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

string

Wymagane. Identyfikator URI zasad zwrotów. Google może użyć tych informacji do sprawdzenia zasad. Musi to być prawidłowy adres URL.

bool

To pole określa, czy sprzedawca akceptuje zwroty tylko w przypadku wadliwych produktów. Jest ono wymagane.

int32

To pole określa liczbę dni, w ciągu której sprzedawcy przetwarzają zwroty środków. Jest ono opcjonalne.

bool

To pole określa, czy sprzedawca zezwala klientom na wymianę produktów. Jest ono wymagane.

Type

Typ zasady.

int64

Liczba dni, w których można zwrócić produkty po ich dostarczeniu. Jeden dzień to 24 godziny od daty dostawy. Wymagane w przypadku zwrotów NUMBER_OF_DAYS_AFTER_DELIVERY.

Price

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

int32

Procent łącznej ceny w milionowych częściach jednostki. 15 000 000 oznacza, że zostanie naliczona opłata w wysokości 15% całkowitej ceny.

Type

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

Price

Stała kwota opłaty za przesyłkę zwrotną. Ta wartość jest stosowana tylko wtedy, gdy typ ma wartość FIXED. Jeśli typ jest ustawiony na FIXED, a wartość nie jest określona, opłata za zwrot będzie traktowana jako bezpłatna.

string

Wymagane. Wyświetlana nazwa tej sezonowej zamiany w Merchant Center.

Date

Wymagane. Określa zakres dat, w którym obowiązuje to sezonowe dostosowanie zasad. Zarówno początek, jak i koniec powinny być podane w formacie daty dziesiętnej, np. 20250115. Daty sezonowych dostosowania zasad nie powinny się nakładać.

Date

Wymagany. Data zakończenia sezonowego dostosowania zasad (włącznie).

Policy

Wymagane. Zasady zwrotów w danym zakresie dat.

string

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

string

Tylko dane wyjściowe. Adres URL strony pomocy Merchant Center, na której opisano program.

State

Tylko dane wyjściowe. Stan udziału konta w programie.

string

Tylko dane wyjściowe. regiony, w których konto aktywnie uczestniczy w programie; Aktywnymi regionami są te, w których zostały spełnione wszystkie wymagania programu dotyczące tych regionów.

Kody regionów są definiowane przez CLDR. Może to być kraj, w którym program jest dostępny, lub 001, jeśli program jest dostępny na całym świecie.

Requirement

Tylko dane wyjściowe. Wymagania, których konto jeszcze nie spełnia i które mają wpływ na udział w programie.

string

Tylko dane wyjściowe. Nazwa wymagań.

string

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

string

Tylko dane wyjściowe. Regiony, które są obecnie objęte tym wymogiem.

Kody regionów są definiowane przez CLDR. Może to być kraj, w którym program jest dostępny, lub 001, jeśli program jest dostępny na całym świecie.

string

Wymagane. Lista etykiet wysyłki określająca produkty, do których ma zastosowanie ta grupa stawek. Jest to dysjunkcja: aby grupa stawek mogła zostać zastosowana, musi pasować tylko jedna z etykietek. Może być pusty tylko w przypadku ostatniej grupy stawek usługi.

Table

Opcjonalnie: Lista podtablic, do których odwołuje się main_table. Można ustawić tylko wtedy, gdy ustawiono wartość main_table.

CarrierRate

Opcjonalnie: Lista stawek operatora, do których można się odwołać za pomocą pola main_table lub single_value.

Value

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

Table

Tabela definiująca grupę stawek, gdy single_value nie jest wystarczająco precyzyjna. Można ustawić tylko wtedy, gdy nie jest ustawiona wartość single_value.

string

Opcjonalnie: Nazwa grupy stawek. Jeśli zestaw musi być niepowtarzalny w ramach usługi dostawy.

string

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

PostalCodeArea

Opcjonalnie: Lista kodów pocztowych, która określa obszar regionu.

GeoTargetArea

Opcjonalnie: Lista celów geograficznych, która definiuje obszar regionu.

BoolValue

Tylko dane wyjściowe. Wskazuje, czy region jest odpowiedni do użycia w konfiguracji asortymentu regionalnego.

BoolValue

Tylko dane wyjściowe. Wskazuje, czy region jest odpowiedni do użycia w konfiguracji Usług dostawy.

string

Opcjonalnie: Wyświetlana nazwa regionu.

int64

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

string

Wymagane. Kod regionu CLDR lub kraj, w którym obowiązuje grupa kodów pocztowych.

PostalCodeRange

Wymagane. zakres kodów pocztowych;

string

Wymagane. Kod pocztowy lub wzór w formie prefiks* oznaczający dolną granicę zakresu definiującego obszar. Przykładowe wartości: 94108, 9410*, 9*.

string

Opcjonalnie: Kod pocztowy lub wzór w formie prefix* określający górną granicę zakresu definiującego obszar. Musi mieć taką samą długość jak postalCodeRangeBegin: jeśli postalCodeRangeBegin to kod pocztowy, to postalCodeRangeEnd też musi być kodem pocztowym; jeśli postalCodeRangeBegin to wzór, to postalCodeRangeEnd też musi być wzorem o tej samej długości prefiksu. Opcjonalnie: jeśli nie jest ustawiony, obszar jest definiowany jako wszystkie kody pocztowe pasujące do postalCodeRangeBegin.

string

termsOfService, które należy zaakceptować.

string

Pełny adres URL pliku z warunkami korzystania z usługi. To pole jest takie samo jak TermsOfService.file_uri i zostało dodane tylko dla wygody.

string

Wymagane. Konto, dla którego chcesz uzyskać stan umowy: accounts/{account}

string

Wymagane. Kod regionu według CLDR. Jest to kod kraju, jeśli warunki korzystania z usługi mają zastosowanie tylko w danym kraju, lub 001, jeśli mają zastosowanie na całym świecie.

TermsOfServiceKind

Wymagane. Rodzaj, do którego odnoszą się te warunki korzystania z usługi.

Value

Wymagane. Lista komórek, które tworzą wiersz. W przypadku tabel dwuwymiarowych musi mieć taką samą długość jak columnHeaders, a w przypadku tabel jednowymiarowych długość 1.

string

Wymagane. Kod regionu CLDR krajów, w których obowiązuje usługa.

RateGroup

Opcjonalnie: Definicje grup stawek dostawy. Tylko ostatnia grupa może mieć pustą wartość applicable_shipping_labels, co oznacza „wszystko inne”. Inne applicable_shipping_labels nie mogą się nakładać.

LoyaltyProgram

Opcjonalnie: Programy lojalnościowe, w przypadku których usługa dostawy jest ograniczona.

string

Wymagane. Wolnoformowa nazwa usługi. Musi być niepowtarzalny na koncie docelowym.

bool

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

string

Kod CLDR waluty, której dotyczy ta usługa. Musi być zgodna z cenami w grupach stawek.

DeliveryTime

Wymagane. Czas spędzony na różnych etapach od zamówienia do dostawy produktu.

ShipmentType

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

Price

Minimalna wartość zamówienia dla tej usługi. Jeśli jest ustawiona, oznacza, że klienci muszą wydać co najmniej tę kwotę. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie. Nie można go ustawić razem z minimum_order_value_table.

MinimumOrderValueTable

Tabela minimalnych wartości zamówień w poszczególnych sklepach w przypadku typu realizacji zamówienia: odbiór w sklepie. Nie można go ustawić razem z parametrem minimum_order_value.

StoreConfig

Lista sklepów, z których dostarczane są Twoje produkty. Dotyczy to tylko dostawy lokalnej.

LoyaltyProgramTiers

Opcjonalnie: Poziom w programie lojalnościowym tej usługi dostawy.

string

Etykieta programu lojalnościowego określona w ustawieniach programu lojalnościowego w Merchant Center. Ten atrybut podrzędny umożliwia Google zmapowanie Twojego programu lojalnościowego w kwalifikujących się ofertach.

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 lojalnościowego w Merchant Center i jest wymagana do zmian w źródle danych, nawet jeśli Twój program lojalnościowy ma tylko jeden poziom.

string

Opcjonalnie: Lista kodów sklepów, które oferują dostawę lokalną. Jeśli jest puste, wartość all_stores musi być TRUE.

StoreServiceType

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

CutoffConfig

Konfiguracje związane z dostawą lokalną kończą się na koniec dnia.

Distance

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

LocalCutoffTime

Godzina zakończenia dostawy lokalnej w danym dniu.

int64

Dotyczy tylko lokalnej realizacji zamówień. Określa czas graniczny jako liczbę godzin przed zamknięciem sklepu. Wyklucza się z opcją local_cutoff_time.

bool

Sprzedawcy mogą zrezygnować z wyświetlania dostawy lokalnej w ciągu n dni, jeśli mają skonfigurowaną usługę dostawy lokalnej w ciągu n dni. Jeśli na przykład usługa dostawy definiuje dostawę tego samego dnia i jest już po dacie granicznej, ustawienie tego pola na true spowoduje, że obliczona stawka za usługę dostawy zwróci wartość NO_DELIVERY_POST_CUTOFF. W tym samym przykładzie ustawienie tego pola na false powoduje, że obliczona dostawa trwa jeden dzień. Dotyczy to tylko dostawy lokalnej.

int64

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

int64

Zamówienia na dostawę tego samego dnia muszą zostać złożone do godziny 12:00.

string

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

Service

Opcjonalnie: Lista usług konta docelowego.

Warehouse

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

string

Wymagane. To pole służy do unikania problemów z asynchronicznością. Upewnij się, że dane ustawień dostawy nie uległy zmianie między wywołaniem funkcji get call a wstawianiem funkcji insert call. Użytkownik powinien wykonać te czynności:

1. Aby utworzyć początkowe ustawienie dostawy, ustaw pole etag jako pusty ciąg znaków.

2. Po utworzeniu metody wywołania wywołaj metodę get, aby uzyskać etag i bieżące dane ustawień dostawy przed wywołaniem insert.

3. Zmień na żądane ustawienia dostawy.

4. Zadzwoń do metody wstawiania z żądanymi informacjami o ustawieniach dostawy i etykietą uzyskaną w kroku 2.

5. Jeśli dane dotyczące ustawień dostawy uległy zmianie między krokiem 2 a krokiem 4. Żądanie wstawienia nie powiedzie się, ponieważ tag zmienia się za każdym razem, gdy zmieniają się dane w ustawieniach dostawy. Użytkownik powinien powtórzyć kroki 2–4, używając nowego znacznika eTag.

Row

Wymagane. Lista wierszy, które tworzą tabelę. Musi mieć taką samą długość jak row_headers.

string

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

Headers

Wymagane. Nagłówki wierszy tabeli.

Headers

Nagłówki kolumn tabeli. Opcjonalnie: jeśli nie jest ustawiony, tabela ma tylko 1 wymiar.

string

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

string

Kod regionu według CLDR. Jest to kraj, w którym warunki korzystania z usługi mają zastosowanie wyłącznie w tym kraju, lub 001, gdy te same TermsOfService mogą być podpisane w dowolnym kraju. Pamiętaj jednak, że podczas podpisywania ogólnych warunków korzystania z usługi nadal oczekujemy podania konkretnego kraju (powinien to być kraj, w którym działa firma sprzedawcy lub kraj, w którym uczestniczy w programie).

TermsOfServiceKind

Rodzaj, do którego odnoszą się te warunki korzystania z usługi.

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 zaakceptować tylko za pomocą zewnętrznych procesów, a nie bezpośrednio przez sprzedawcę w interfejsie użytkownika lub interfejsie API.

string

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

string

Identyfikator. Nazwa zasobu wersji warunków korzystania z usługi. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Format identyfikatora: {TermsOfServiceKind}-{country} Przykład identyfikatora: MERCHANT_CENTER-US

string

Kod regionu zgodnie z definicją na stronie https://cldr.unicode.org/. Kraj, w którym obowiązuje bieżący stan.

TermsOfServiceKind

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

Accepted

Zaakceptowane warunki korzystania z usługi tego typu i powiązanego regionu_code

Required

Wymagane warunki korzystania z usługi

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"]. Wskazywane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi.

string

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

TransitTimeRow

Wymagane. Jeśli występuje tylko 1 zbiór wymiarów postal_code_group_names lub transit_time_labels, w przypadku tego wymiaru występuje kilka wierszy, z których każdy ma po 1 wartości. Jeśli występują 2 wymiary, każdy wiersz odpowiada postal_code_group_names, a kolumny (wartości) – transit_time_labels.

TransitTimeValue

Wymagane. Zakres czasu przewozu (min-max) w dniach roboczych.

int32

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

int32

Musi być równa lub większa niż min_transit_days.

string

Wymagane. Nazwa strony głównej, z której chcesz zrezygnować z roszczenia. Format: accounts/{account}/homepage

Account

Wymagane. Nowa wersja konta.

FieldMask

Opcjonalnie: Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• account_name
• adult_content
• language_code
• time_zone

AutofeedSettings

Wymagane. Nowa wersja ustawienia automatycznego przesyłania.

FieldMask

Wymagane. Lista pól, które są aktualizowane.

BusinessIdentity

Wymagane. Nowa wersja tożsamości firmy.

FieldMask

Opcjonalnie: Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• black_owned
• latino_owned
• promotions_consent
• small_business
• veteran_owned
• women_owned

BusinessInfo

Wymagane. Nowa wersja informacji o firmie.

FieldMask

Opcjonalnie: Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• address
• customer_service
• korean_business_registration_number

EmailPreferences

Wymagane. Ustawienia powiadomień e-mail do zaktualizowania.

FieldMask

Wymagane. Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• news_and_tips

Homepage

Wymagane. Nowa wersja strony głównej.

FieldMask

Opcjonalnie: Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• uri

Region

Wymagane. Zaktualizowany region.

FieldMask

Opcjonalnie: Maska pól rozdzielona przecinkami, która wskazuje pola do zaktualizowania. Przykład: "displayName,postalCodeArea.regionCode".

User

Wymagane. Nowa wersja użytkownika.

Użyj me, aby wskazać swój adres e-mail, na przykład accounts/{account}/users/me.

FieldMask

Opcjonalnie: Lista pól, które są aktualizowane.

Obsługiwane są te pola (zarówno w przypadku snake_case, jak i lowerCamelCase):

• access_rights

string

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

Użyj me, aby wskazać swój adres e-mail, na przykład accounts/{account}/users/me.

State

Tylko dane wyjściowe. Stan użytkownika.

AccessRight

Opcjonalnie: Uprawnienia dostępu użytkownika.

bool

Jeśli wartość to prawda, produkt nie może być wysyłany. Gdy jest ustawione, musi mieć wartość Prawda. Można je ustawić tylko wtedy, gdy wszystkie inne pola są puste.

Price

Stawka stała. Można go ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

string

Odsetek ceny reprezentowany jako liczba w zapisie dziesiętnym (np. "5.4"). Można go ustawić tylko wtedy, gdy wszystkie inne pola są puste.

string

Nazwa stawki przewoźnika odnosząca się do stawki przewoźnika zdefiniowanej w tej samej grupie stawek. Można je ustawić tylko wtedy, gdy nie są ustawione żadne inne pola.

string

Nazwa podtabeli. Można je ustawić tylko w komórkach tabeli (nie w przypadku pojedynczych wartości) i tylko wtedy, gdy wszystkie pozostałe pola są puste.

string

Wymagane. Nazwa magazynu. Musi być unikalna na koncie.

Address

Wymagane. Adres dostawy magazynu.

WarehouseCutoffTime

Wymagane. Najpóźniejszą porę dnia, do której można przyjąć zamówienie i rozpocząć jego przetwarzanie. Późniejsze zamówienia zostaną przetworzone następnego dnia. Czas jest określany na podstawie kodu pocztowego magazynu.

int64

Wymagane. Liczba dni potrzebnych magazynowi na zapakowanie i wysłanie produktu. Jest to ustawiane na poziomie magazynu, ale można je zastąpić na poziomie oferty na podstawie atrybutów produktu.

BusinessDayConfig

dni roboczych magazynu; Jeśli nie zostanie skonfigurowany, domyślnie będzie obowiązywać od poniedziałku do piątku.

string

Wymagane. Operator, np. "UPS" lub "Fedex". obsługiwani operatorzy

string

Wymagane. Usługa operatora, np. "ground" lub "2 days". Nazwa usługi musi znajdować się na liście eddSupportedServices.

string

Wymagane. Nazwa magazynu. Powinna być zgodna z [warehouse][ShippingSetting.warehouses.name]

int32

Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia przez magazyn. Godzina jest określana na podstawie strefy czasowej magazynu.

int32

Wymagane. Minuta ostatecznego terminu, do którego należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia przez magazyn. Minuty są obliczane na podstawie strefy czasowej magazynu.