Indeks
AccountIssueService
(interfejs)AccountsService
(interfejs)BusinessIdentityService
(interfejs)BusinessInfoService
(interfejs)EmailPreferencesService
(interfejs)HomepageService
(interfejs)OnlineReturnPolicyService
(interfejs)ProgramsService
(interfejs)RegionsService
(interfejs)ShippingSettingsService
(interfejs)TermsOfServiceAgreementStateService
(interfejs)TermsOfServiceService
(interfejs)UserService
(interfejs)AcceptTermsOfServiceRequest
(komunikat)Accepted
(komunikat)AccessRight
(wyliczenie)Account
(komunikat)AccountIssue
(komunikat)AccountIssue.ImpactedDestination
(komunikat)AccountIssue.ImpactedDestination.Impact
(komunikat)AccountIssue.Severity
(wyliczenie)Address
(komunikat)BusinessDayConfig
(komunikat)BusinessDayConfig.Weekday
(wyliczenie)BusinessIdentity
(komunikat)BusinessIdentity.IdentityAttribute
(komunikat)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(wyliczenie)BusinessIdentity.PromotionsConsent
(wyliczenie)BusinessInfo
(komunikat)CarrierRate
(komunikat)ClaimHomepageRequest
(komunikat)CreateAndConfigureAccountRequest
(komunikat)CreateAndConfigureAccountRequest.AcceptTermsOfService
(komunikat)CreateAndConfigureAccountRequest.AddAccountService
(komunikat)CreateRegionRequest
(komunikat)CreateUserRequest
(komunikat)CustomerService
(komunikat)CutoffTime
(komunikat)DeleteAccountRequest
(komunikat)DeleteRegionRequest
(komunikat)DeleteUserRequest
(komunikat)DeliveryTime
(komunikat)DisableProgramRequest
(komunikat)Distance
(komunikat)Distance.Unit
(wyliczenie)EmailPreferences
(komunikat)EmailPreferences.OptInState
(wyliczenie)EnableProgramRequest
(komunikat)GetAccountRequest
(komunikat)GetBusinessIdentityRequest
(komunikat)GetBusinessInfoRequest
(komunikat)GetEmailPreferencesRequest
(komunikat)GetHomepageRequest
(komunikat)GetOnlineReturnPolicyRequest
(komunikat)GetProgramRequest
(komunikat)GetRegionRequest
(komunikat)GetShippingSettingsRequest
(komunikat)GetTermsOfServiceAgreementStateRequest
(komunikat)GetTermsOfServiceRequest
(komunikat)GetUserRequest
(komunikat)Headers
(komunikat)Homepage
(komunikat)InsertShippingSettingsRequest
(komunikat)ListAccountIssuesRequest
(komunikat)ListAccountIssuesResponse
(komunikat)ListAccountsRequest
(komunikat)ListAccountsResponse
(komunikat)ListOnlineReturnPoliciesRequest
(komunikat)ListOnlineReturnPoliciesResponse
(komunikat)ListProgramsRequest
(komunikat)ListProgramsResponse
(komunikat)ListRegionsRequest
(komunikat)ListRegionsResponse
(komunikat)ListSubAccountsRequest
(komunikat)ListSubAccountsResponse
(komunikat)ListUsersRequest
(komunikat)ListUsersResponse
(komunikat)LocationIdSet
(komunikat)MinimumOrderValueTable
(komunikat)MinimumOrderValueTable.StoreCodeSetWithMov
(komunikat)OnlineReturnPolicy
(komunikat)OnlineReturnPolicy.ItemCondition
(wyliczenie)OnlineReturnPolicy.Policy
(komunikat)OnlineReturnPolicy.Policy.Type
(wyliczenie)OnlineReturnPolicy.RestockingFee
(komunikat)OnlineReturnPolicy.ReturnMethod
(wyliczenie)OnlineReturnPolicy.ReturnShippingFee
(komunikat)OnlineReturnPolicy.ReturnShippingFee.Type
(wyliczenie)PhoneVerificationState
(wyliczenie)Program
(komunikat)Program.Requirement
(komunikat)Program.State
(wyliczenie)RateGroup
(komunikat)Region
(komunikat)Region.GeoTargetArea
(komunikat)Region.PostalCodeArea
(komunikat)Region.PostalCodeArea.PostalCodeRange
(komunikat)Required
(komunikat)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(komunikat)RetrieveLatestTermsOfServiceRequest
(komunikat)Row
(komunikat)Service
(komunikat)Service.LoyaltyProgram
(komunikat)Service.LoyaltyProgram.LoyaltyProgramTiers
(komunikat)Service.ShipmentType
(wyliczenie)Service.StoreConfig
(komunikat)Service.StoreConfig.CutoffConfig
(komunikat)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(komunikat)Service.StoreConfig.StoreServiceType
(wyliczenie)ShippingSettings
(komunikat)Table
(komunikat)TermsOfService
(komunikat)TermsOfServiceAgreementState
(komunikat)TermsOfServiceKind
(wyliczenie)TransitTable
(komunikat)TransitTable.TransitTimeRow
(komunikat)TransitTable.TransitTimeRow.TransitTimeValue
(komunikat)UnclaimHomepageRequest
(komunikat)UpdateAccountRequest
(komunikat)UpdateBusinessIdentityRequest
(komunikat)UpdateBusinessInfoRequest
(komunikat)UpdateEmailPreferencesRequest
(komunikat)UpdateHomepageRequest
(komunikat)UpdateRegionRequest
(komunikat)UpdateUserRequest
(komunikat)User
(komunikat)User.State
(wyliczenie)Value
(komunikat)Warehouse
(komunikat)WarehouseBasedDeliveryTime
(komunikat)WarehouseCutoffTime
(komunikat)
AccountIssueService
Usługa obsługująca interfejs AccountIssueService
API.
ListAccountIssues |
---|
Lista wszystkich problemów z kontem Merchant Center.
|
AccountsService
Usługa obsługująca Account API.
CreateAndConfigureAccount |
---|
Tworzy samodzielne konto Merchant Center z dodatkową konfiguracją. Dodaje użytkownika, który przesłał prośbę, w roli administratora nowego konta.
|
DeleteAccount |
---|
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.
|
GetAccount |
---|
Pobiera konto z Twojego konta Merchant Center. Po wstawieniu, zaktualizowaniu lub usunięciu konta może minąć kilka minut, zanim zmiany zaczną obowiązywać.
|
ListAccounts |
---|
Zawiera listę kont, do których ma dostęp użytkownik nawiązujący 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.
|
ListSubAccounts |
---|
Wymień wszystkie subkonta danego multikonta klientów. Jest to wygodny kod zapewniający bardziej wydajną metodę
|
UpdateAccount |
---|
Aktualizuje konto niezależnie od jego typu: samodzielne, multikonto klientów czy subkonto. Ta metoda wymaga dostępu administracyjnego.
|
BusinessIdentityService
Usługa obsługująca interfejs API firmy tożsamości.
GetBusinessIdentity |
---|
Pobiera tożsamość firmy z konta.
|
UpdateBusinessIdentity |
---|
Aktualizuje tożsamość firmy na koncie. Ta metoda wymaga dostępu administracyjnego.
|
BusinessInfoService
Usługa obsługująca interfejs API informacji o firmie.
GetBusinessInfo |
---|
Pobiera informacje o firmie z konta.
|
UpdateBusinessInfo |
---|
Aktualizuje informacje o firmie na koncie. Ta metoda wymaga dostępu administracyjnego.
|
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 |
---|
Zwraca ustawienia e-mail użytkownika konta Merchant Center. Aby pobrać ustawienia uwierzytelnionego użytkownika, użyj aliasu name=accounts/*/users/me/emailPreferences.
|
UpdateEmailPreferences |
---|
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.
|
HomepageService
Usługa obsługująca interfejs API dla strony głównej sklepu.
ClaimHomepage |
---|
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 więcej szczegółów będzie dostępnych w komunikacie o błędzie).
|
GetHomepage |
---|
Pobiera stronę główną sklepu.
|
UnclaimHomepage |
---|
Usuwa prawa do strony głównej sklepu. Ta metoda wymaga dostępu administracyjnego.
|
UpdateHomepage |
---|
Aktualizuje stronę główną sklepu. Ta metoda wymaga dostępu administracyjnego.
|
OnlineReturnPolicyService
Usługa ułatwia zarządzanie konfiguracją zasad zwrotów sprzedawcy w przypadku rezygnacji z zakupu, co 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 |
---|
Pobiera istniejące zasady zwrotów.
|
ListOnlineReturnPolicies |
---|
Wyświetla listę wszystkich istniejących zasad zwrotów.
|
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 |
---|
Wyłącz na koncie udział w określonym programie. Ta metoda wymaga dostępu administracyjnego.
|
EnableProgram |
---|
Włącz na koncie udział w określonym programie. Ta metoda wymaga dostępu administracyjnego.
|
GetProgram |
---|
Pobiera określony program dla konta.
|
ListPrograms |
---|
Pobiera wszystkie programy na koncie.
|
RegionsService
Zarządza konfiguracją regionów.
Ten interfejs API definiuje ten model zasobów:
Region
CreateRegion |
---|
Tworzy definicję regionu na koncie Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
DeleteRegion |
---|
Usuwa definicję regionu z Twojego konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
GetRegion |
---|
Pobiera region zdefiniowany na Twoim koncie Merchant Center.
|
ListRegions |
---|
Wyświetla listę regionów na Twoim koncie Merchant Center.
|
UpdateRegion |
---|
Aktualizuje definicję regionu na koncie Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
ShippingSettingsService
Usługa, która pobiera informacje o ustawieniach dostawy metodą wywołania metody dla metody w interfejsie API sprzedawcy.
GetShippingSettings |
---|
Pobieranie informacji o ustawieniach dostawy.
|
InsertShippingSettings |
---|
Zastąp ustawienia dostawy u sprzedawcy ustawieniem dostawy. Ta metoda wymaga dostępu administracyjnego.
|
TermsOfServiceAgreementStateService
Usługa obsługująca interfejs TermsOfServiceAgreementState
API.
GetTermsOfServiceAgreementState |
---|
Zwraca stan umowy dotyczącej warunków korzystania z usługi.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Pobiera stan umowy na warunki korzystania z aplikacji.
|
TermsOfServiceService
Usługa obsługująca interfejs TermsOfService
API.
AcceptTermsOfService |
---|
Akceptuje
|
GetTermsOfService |
---|
Pobiera obiekt
|
RetrieveLatestTermsOfService |
---|
Pobiera najnowszą wersję usługi
|
UserService
Usługa obsługująca interfejs API użytkownika.
CreateUser |
---|
Tworzy użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
DeleteUser |
---|
Usuwa użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
GetUser |
---|
Pobiera użytkownika konta Merchant Center.
|
ListUsers |
---|
Zawiera listę wszystkich użytkowników konta Merchant Center.
|
UpdateUser |
---|
Aktualizuje użytkownika konta Merchant Center. Ta metoda wymaga dostępu administracyjnego.
|
AcceptTermsOfServiceRequest
Komunikat żądania dla metody AcceptTermsOfService
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: |
account |
Wymagane. Konto, w przypadku którego chcesz zaakceptować Warunki korzystania z usługi. |
region_code |
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 |
zaakceptowane termsOfService. |
accepted_by |
Konto, na którym została zarejestrowana akceptacja. Może to być samo konto lub, w przypadku subkont, konto MCA. |
valid_until |
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 |
Identyfikator. Nazwa zasobu konta. Format: |
account_id |
Tylko dane wyjściowe. Identyfikator konta. |
account_name |
Wymagane. Czytelna dla człowieka nazwa konta. Więcej informacji znajdziesz w polach nazwa sklepu i nazwa firmy. |
adult_content |
Określa, czy to konto zawiera treści dla dorosłych. |
test_account |
Tylko dane wyjściowe. Wskazuje, czy jest to konto testowe. |
time_zone |
Wymagane. Strefa czasowa konta. Przy zapisach W przypadku odczytów |
language_code |
Wymagane. Kod języka BCP-47 konta, na przykład |
AccountIssue
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu, którego dotyczy problem na koncie. Format: |
title |
Zlokalizowany tytuł problemu. |
severity |
Ogólna ważność problemu. |
impacted_destinations[] |
Wpływ tego problemu na różne miejsca docelowe. |
detail |
Dalsze zlokalizowane informacje o tym problemie. |
documentation_uri |
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[] |
(negatywny) wpływ na różne regiony w danym miejscu docelowym; |
reporting_context |
Kontekst raportowania, którego to dotyczy. |
Wpływ
Wpływ problemu na region.
Pola | |
---|---|
region_code |
Kod regionu CLDR, w którym występuje problem. |
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. |
Adres
Adres dostawy magazynu.
Pola | |
---|---|
street_address |
Część adresu na poziomie ulicy. Na przykład: |
city |
Wymagane. Miasto, miejscowość lub gmina. Może obejmować również zależne miejscowości lub dzielnice (np. dzielnice lub przedmieścia). |
administrative_area |
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 |
Wymagane. Kod pocztowy (na przykład „94043”). |
region_code |
Wymagane. Kod kraju CLDR (np. „PL”). |
BusinessDayConfig
Dni robocze w magazynie.
Pola | |
---|---|
business_days[] |
Wymagane. Zwykłe dni robocze. Pole nie może być puste. |
Dzień tygodnia
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 |
Identyfikator. Nazwa zasobu tożsamości firmy. Format: |
promotions_consent |
Opcjonalnie: Określa, czy atrybuty tożsamości mogą być używane w promocjach. |
black_owned |
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 |
women_owned |
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 |
veteran_owned |
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 |
latino_owned |
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 |
small_business |
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 |
IdentityAttribute
Wszystkie informacje dotyczące atrybutu tożsamości.
Pola | |
---|---|
identity_declaration |
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 | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Wartość domyślna wskazująca, że nie dokonano wyboru. |
PROMOTIONS_CONSENT_GIVEN |
Wskazuje, że użytkownik konta wyraził zgodę na wykorzystywanie tożsamości firmy na potrzeby promocji. |
PROMOTIONS_CONSENT_DENIED |
oznacza, że właściciel konta nie wyraził zgody na wykorzystywanie tożsamości firmy na potrzeby promocji. |
BusinessInfo
Zbieranie informacji o firmie.
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu informacji o firmie. Format: |
address |
Opcjonalnie: Adres firmy. |
phone |
Tylko dane wyjściowe. Numer telefonu firmy. |
phone_verification_state |
Tylko dane wyjściowe. Stan weryfikacji telefonicznej firmy. |
customer_service |
Opcjonalnie: Obsługa klienta w firmie. |
korean_business_registration_number |
Opcjonalnie: 10-cyfrowy koreański numer rejestracyjny firmy rozdzielony myślnikami w formacie: XXX-XX-XXXXX. |
CarrierRate
Lista stawek przewoźnika, do których można się odwołać w: main_table
lub single_value
.
Pola | |
---|---|
name |
Wymagane. Nazwa stawki przewoźnika. Wartość nie może się powtarzać w każdej grupie stawek. |
carrier |
Wymagane. Usługa przewoźnika, na przykład |
carrier_service |
Wymagane. Usługa przewoźnika, na przykład |
origin_postal_code |
Wymagane. Punkt początkowy dostawy dla stawki tego przewoźnika. |
percentage_adjustment |
Opcjonalnie: Mnożący modyfikator stawki dostawy w postaci liczby w zapisie dziesiętnym. Może być ujemna. Na przykład |
flat_adjustment |
Opcjonalnie: Addytywny modyfikator stawki dostawy. Może być ujemna. Na przykład |
ClaimHomepageRequest
Komunikat żądania dla metody ClaimHomepage
.
Pola | |
---|---|
name |
Wymagane. Nazwa strony głównej, do której chcesz zgłosić prawa. Format: |
CreateAndConfigureAccountRequest
Komunikat żądania dla metody CreateAndConfigureAccount
.
Pola | |
---|---|
account |
Wymagane. Konto, które zostanie utworzone. |
users[] |
Opcjonalnie: Użytkownicy, którzy zostaną dodani do konta. |
service[] |
Wymagane. Usługa na koncie między utworzonym kontem a kontem dostawcy jest inicjowana podczas tworzenia. Musisz świadczyć co najmniej jedną taką usługę. Obecnie obsługiwana jest tylko usługa |
accept_terms_of_service |
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 |
Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. |
region_code |
Wymagane. Kod regionu określony przez CLDR. Wybierz kraj, w którym Warunki korzystania z usługi obowiązują w danym kraju, lub |
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 |
Dostawca to pośrednik dla konta. |
provider |
Opcjonalnie: Dostawca usługi. Format: |
CreateRegionRequest
Komunikat żądania dla metody CreateRegion
.
Pola | |
---|---|
parent |
Wymagane. Konto, dla którego chcesz utworzyć region. Format: |
region_id |
Wymagane. Identyfikator regionu unikalny dla wszystkich regionów tego samego konta. |
region |
Wymagane. Region do utworzenia. |
CreateUserRequest
Komunikat żądania dla metody CreateUser
.
Pola | |
---|---|
parent |
Wymagane. Nazwa zasobu konta, dla którego zostanie utworzony użytkownik. Format: |
user_id |
Wymagane. Adres e-mail użytkownika (np. |
user |
Wymagane. Użytkownik, który ma zostać utworzony. |
CustomerService
Informacje o obsłudze klienta.
Pola | |
---|---|
uri |
Opcjonalnie: Identyfikator URI, pod którym można znaleźć obsługę klienta. |
email |
Opcjonalnie: Adres e-mail, pod którym można skontaktować się z obsługą klienta. |
phone |
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 |
Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało przetworzone tego samego dnia. |
minute |
Wymagane. Minuta ostatecznych terminów, do których należy złożyć zamówienie, aby zostało przetworzone tego samego dnia. |
time_zone |
Wymagane. Identyfikator strefy czasowej, na przykład „Europa/Zurych”. |
DeleteAccountRequest
Komunikat żądania dla metody DeleteAccount
.
Pola | |
---|---|
name |
Wymagane. Nazwa konta do usunięcia. Format: |
DeleteRegionRequest
Komunikat żądania dla metody DeleteRegion
.
Pola | |
---|---|
name |
Wymagane. Nazwa regionu do usunięcia. Format: |
DeleteUserRequest
Komunikat żądania dla metody DeleteUser
.
Pola | |
---|---|
name |
Wymagane. Nazwa użytkownika, którego konto chcesz usunąć. Format: Można też usunąć użytkownika odpowiadającego rozmówcy, używając pola |
DeliveryTime
Czas potrzebny na wykonanie różnych czynności – od złożenia zamówienia po dostarczenie produktu
Pola | |
---|---|
warehouse_based_delivery_times[] |
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 |
Minimalna liczba dni roboczych przewozu. 0 oznacza dostawę tego samego dnia, 1 oznacza dostawę następnego dnia. Należy ustawić wartość |
max_transit_days |
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ż |
cutoff_time |
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 |
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 |
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ż |
transit_time_table |
Tabela czasu przewozu, liczba dni roboczych podczas przesyłania na podstawie wymiarów wierszy i kolumn. Można ustawić jedną z tych wartości: |
handling_business_day_config |
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 |
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 metodyDisableProgram.
Pola | |
---|---|
name |
Wymagane. Nazwa programu, w którym nie można korzystać z danego konta. Format: |
Odległość
Maksymalny promień dostawy. Jest to wymagane tylko w przypadku dostawy lokalnej.
Pola | |
---|---|
value |
Liczba całkowita odległości. |
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 |
Identyfikator. Nazwa pola EmailPreferences. Punkt końcowy jest obsługiwany tylko w przypadku uwierzytelnionego użytkownika. |
news_and_tips |
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 |
Wymagane. Nazwa programu, w którym można wziąć udział w przypadku danego konta. Format: |
GetAccountRequest
Komunikat żądania dla metody GetAccount
.
Pola | |
---|---|
name |
Wymagane. Nazwa konta do pobrania. Format: |
GetBusinessIdentityRequest
Komunikat żądania dla metody GetBusinessIdentity
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu tożsamości firmy. Format: |
GetBusinessInfoRequest
Komunikat żądania dla metody GetBusinessInfo
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu informacji o firmie. Format: |
GetEmailPreferencesRequest
Żądanie komunikatu dotyczącego metody GetEmailPreferences.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu |
GetHomepageRequest
Komunikat żądania dla metody GetHomepage
.
Pola | |
---|---|
name |
Wymagane. Nazwa strony głównej do pobrania. Format: |
GetOnlineReturnPolicyRequest
Komunikat żądania dla metody GetOnlineReturnPolicy
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasady zwrotów do pobrania. Format: |
GetProgramRequest
Komunikat żądania metody GetProgram.
Pola | |
---|---|
name |
Wymagane. Nazwa programu do pobrania. Format: |
GetRegionRequest
Komunikat żądania dla metody GetRegion
.
Pola | |
---|---|
name |
Wymagane. Nazwa regionu do pobrania. Format: |
GetShippingSettingsRequest
Komunikat żądania dla metody GetShippingSetting
.
Pola | |
---|---|
name |
Wymagane. Nazwa ustawienia dostawy do pobrania. Format: |
GetTermsOfServiceAgreementStateRequest
Komunikat żądania dla metody GetTermsOfServiceAgreementState
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: |
GetTermsOfServiceRequest
Komunikat żądania dla metody GetTermsOfService
.
Pola | |
---|---|
name |
Wymagane. Nazwa zasobu wersji warunków korzystania z usługi. Format: |
GetUserRequest
Komunikat żądania dla metody GetUser
.
Pola | |
---|---|
name |
Wymagane. Nazwa użytkownika do pobrania. Format: Możliwe jest też pobranie informacji o użytkowniku powiązanym z rozmówcą, używając parametru |
Nagłówki
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[] |
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 |
weights[] |
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 |
number_of_items[] |
Wymagane. Lista górnych granic uwzględniających liczbę elementów. Ostatnia wartość może wynosić |
postal_code_group_names[] |
Wymagane. Lista nazw grup pocztowych. Ostatnia wartość może wynosić |
locations[] |
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 |
Identyfikator. Nazwa zasobu strony głównej sklepu. Format: |
claimed |
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 |
Wymagane. Identyfikator URI (zwykle URL) strony głównej sklepu. |
InsertShippingSettingsRequest
Komunikat żądania dla metody InsertShippingSetting
.
Pola | |
---|---|
parent |
Wymagane. Konto, na którym chcesz wstawić ten produkt. Format: konta/{konto} |
shipping_setting |
Wymagane. Nowa wersja konta. |
ListAccountIssuesRequest
Komunikat żądania dla metody ListAccountIssues
.
Pola | |
---|---|
parent |
Wymagane. Element nadrzędny, który jest właścicielem tej kolekcji problemów. Format: |
page_size |
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 |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
language_code |
Opcjonalnie: Problemy w odpowiedzi będą miały pola zrozumiałe dla człowieka w danym języku. Format to BCP-47, na przykład |
time_zone |
Opcjonalnie: Strefa czasowa IANA używana do lokalizowania godzin w polach zrozumiałych dla człowieka. Przykład: „Ameryka/Los_Angeles”. Jeśli nie jest ustawiona, „Ameryka/Los_Angeles” . |
ListAccountIssuesResponse
Komunikat odpowiedzi dla metody ListAccountIssues
.
Pola | |
---|---|
account_issues[] |
Problemy z określonego konta. |
next_page_token |
Token, który może zostać wysłany jako |
ListAccountsRequest
Komunikat żądania dla metody ListAccounts
.
Pola | |
---|---|
page_size |
Opcjonalnie: Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwracanych jest maksymalnie 250 kont. Maksymalna wartość to 500. wartości powyżej 500 są zmieniane na 500. |
page_token |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
filter |
Opcjonalnie: Zwraca tylko konta pasujące do filtra. Więcej informacji znajdziesz w dokumentacji składni filtrów. |
ListAccountsResponse
Komunikat odpowiedzi dla metody ListAccounts
.
Pola | |
---|---|
accounts[] |
Konta pasujące do: |
next_page_token |
Token, który może zostać wysłany jako |
ListOnlineReturnPoliciesRequest
Komunikat żądania dla metody ListOnlineReturnPolicies
.
Pola | |
---|---|
parent |
Wymagane. Konto sprzedawcy, dla którego chcesz wyświetlić zasady zwrotów. Format: |
page_size |
Opcjonalnie: Maksymalna liczba zasobów ( |
page_token |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListOnlineReturnPoliciesResponse
Komunikat odpowiedzi dla metody ListOnlineReturnPolicies
.
Pola | |
---|---|
online_return_policies[] |
Pobrane zasady zwrotów. |
next_page_token |
Token, który może zostać wysłany jako |
ListProgramsRequest
Komunikat żądania dla metody ListPrograms.
Pola | |
---|---|
parent |
Wymagane. Nazwa konta, z którego mają zostać pobrane wszystkie programy. Format: |
page_size |
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 |
Opcjonalnie: Token kontynuacji, odebrany z poprzedniego wywołania |
ListProgramsResponse
Komunikat odpowiedzi dla metody ListPrograms.
Pola | |
---|---|
programs[] |
Programy dla danego konta. |
next_page_token |
Token, który może zostać wysłany jako |
ListRegionsRequest
Komunikat żądania dla metody ListRegions
.
Pola | |
---|---|
parent |
Wymagane. Konto, dla którego chcesz wyświetlić listę regionów. Format: |
page_size |
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 |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListRegionsResponse
Komunikat odpowiedzi dla metody ListRegions
.
Pola | |
---|---|
regions[] |
Regiony określonego sprzedawcy. |
next_page_token |
Token, który może zostać wysłany jako |
ListSubAccountsRequest
Komunikat żądania dla metody ListSubAccounts
.
Pola | |
---|---|
provider |
Wymagane. Konto nadrzędne. Format: |
page_size |
Opcjonalnie: Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwracanych jest maksymalnie 250 kont. Maksymalna wartość to 500. wartości powyżej 500 są zmieniane na 500. |
page_token |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListSubAccountsResponse
Komunikat odpowiedzi dla metody ListSubAccounts
.
Pola | |
---|---|
accounts[] |
Konta, w przypadku których dane konto nadrzędne jest pośrednikiem. |
next_page_token |
Token, który może zostać wysłany jako |
ListUsersRequest
Komunikat żądania dla metody ListUsers
.
Pola | |
---|---|
parent |
Wymagane. Podmiot nadrzędny, do którego należy ta kolekcja użytkowników. Format: |
page_size |
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 |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu |
ListUsersResponse
Komunikat odpowiedzi dla metody ListUsers
.
Pola | |
---|---|
users[] |
Użytkownicy z określonego konta. |
next_page_token |
Token, który może zostać wysłany jako |
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[] |
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[] |
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[] |
Opcjonalnie: Lista unikalnych kodów sklepów lub pusta w przypadku kategorii typu „catch wszystko”. |
value |
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 |
Identyfikator. Nazwa zasobu |
return_policy_id |
Tylko dane wyjściowe. Identyfikator zasad zwrotów wygenerowany przez Google. |
label |
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 produkt nie zawiera określonego 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[] |
Kraje sprzedaży, w których obowiązują zasady zwrotów. Wartości muszą być prawidłowym 2-literowym kodem ISO 3166. |
policy |
Zasady zwrotów. |
restocking_fee |
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[] |
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[] |
Warunki akceptowane w przypadku zwrotów nie mogą być puste, chyba że typ zasad zwrotów to „noReturns”. |
return_shipping_fee |
Opłata za przesyłkę zwrotną. Należy go ustawić tylko wtedy, gdy klient musi pobrać i wydrukować etykietę zwrotną. |
return_policy_uri |
Identyfikator URI zasad zwrotów. Google może go użyć, aby sprawdzić poprawność zasad. Podaj prawidłowy URL. |
accept_defective_only |
To pole określa, czy sprzedawca akceptuje tylko wadliwe produkty i że jest wymagane. |
process_refund_days |
Pole określa liczbę dni potrzebnych sprzedawcom na przetworzenie zwrotu środków. Pole jest opcjonalne. |
accept_exchange |
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 |
Typ zasady. |
days |
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 |
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
|
|
fixed_fee |
Stała opłata za uzupełnienie towarów. |
micro_percent |
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 |
Typ opłaty za przesyłkę zwrotną. |
fixed_fee |
Stała kwota opłaty za przesyłkę zwrotną. Ta wartość ma zastosowanie tylko wtedy, gdy typ to |
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 |
Identyfikator. Nazwa zasobu programu. Format: |
documentation_uri |
Tylko dane wyjściowe. Adres URL strony pomocy Merchant Center opisującej program. |
state |
Tylko dane wyjściowe. Stan konta w programie. |
active_region_codes[] |
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 |
unmet_requirements[] |
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 |
Tylko dane wyjściowe. Nazwa wymagania. |
documentation_uri |
Tylko dane wyjściowe. Adres URL strony pomocy opisującej wymaganie. |
affected_region_codes[] |
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 |
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[] |
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[] |
Opcjonalnie: Lista podtabel, do których odwołuje się |
carrier_rates[] |
Opcjonalnie: Lista stawek przewoźnika, do których można się odwołać w: |
single_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 |
Tabela określająca grupę stawek, gdy |
name |
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 |
Identyfikator. Nazwa zasobu regionu. Format: |
postal_code_area |
Opcjonalnie: Lista kodów pocztowych definiujących obszar regionu. |
geotarget_area |
Opcjonalnie: Lista celów geograficznych definiujących obszar regionu. |
regional_inventory_eligible |
Tylko dane wyjściowe. Wskazuje, czy region kwalifikuje się do użycia w konfiguracji regionalnego asortymentu. |
shipping_eligible |
Tylko dane wyjściowe. Wskazuje, czy region kwalifikuje się do użycia w konfiguracji usług dostawy. |
display_name |
Opcjonalnie: Wyświetlana nazwa regionu. |
GeoTargetArea
Lista celów geograficznych definiujących obszar regionu.
Pola | |
---|---|
geotarget_criteria_ids[] |
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 |
Wymagane. Kod regionu CLDR lub kraj, którego dotyczy dana grupa kodów pocztowych. |
postal_codes[] |
Wymagane. Zakres kodów pocztowych. |
PostalCodeRange
Zakres kodów pocztowych, który określa obszar regionu.
Pola | |
---|---|
begin |
Wymagane. Kod pocztowy lub wzorzec prefiksu formularza* wyznaczający dolną granicę zakresu definiującego obszar. Przykładowe wartości: |
end |
Opcjonalnie: Kod pocztowy lub wzór postaci |
Wymagane
Opisuje warunki korzystania z usługi, które należy zaakceptować.
Pola | |
---|---|
terms_of_service |
termsOfService, które należy zaakceptować. |
tos_file_uri |
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 |
Wymagane. Konto, w przypadku którego ma zostać pobrany w tym formacie: |
RetrieveLatestTermsOfServiceRequest
Komunikat żądania dla metody RetrieveLatestTermsOfService
.
Pola | |
---|---|
region_code |
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 |
Rodzaj, którego dotyczy ta wersja warunków korzystania z usługi. |
Wiersz
Uwzględnij listę komórek.
Pola | |
---|---|
cells[] |
Wymagane. Lista komórek tworzących wiersz. Musi mieć taką samą długość jak |
Usługa
Usługa dostawy.
Pola | |
---|---|
delivery_countries[] |
Wymagane. Kod regionu CLDR obowiązujący w przypadku krajów, w których usługa jest dostępna. |
rate_groups[] |
Opcjonalnie: Definicje grup kosztów dostawy. Tylko ostatni plik może mieć pustą wartość |
loyalty_programs[] |
Opcjonalnie: Programy lojalnościowe, do których jest ograniczona ta usługa dostawy. |
service_name |
Wymagane. Swobodna nazwa usługi. Musi być niepowtarzalna w obrębie konta docelowego. |
active |
Wymagane. Wartość logiczna pokazująca aktywny stan usługi dostawy. |
currency_code |
Kod CLDR waluty, do której odnosi się dana usługa. Musi odpowiadać cenom w grupach stawek. |
delivery_time |
Wymagane. Czas potrzebny na wykonanie różnych czynności – od złożenia zamówienia po dostarczenie produktu |
shipment_type |
Typ lokalizacji, do których ta usługa wysyła zamówienia. |
minimum_order_value |
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 |
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 |
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[] |
Opcjonalnie: Poziom programu lojalnościowego tej usługi dostawy. |
program_label |
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 |
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[] |
Opcjonalnie: Lista kodów sklepów z dostawą lokalną. Jeśli pole jest puste, pole |
store_service_type |
Wskazuje, czy wszystkie lub wybrane sklepy wymienione przez tego sprzedawcę oferują dostawę lokalną. |
cutoff_config |
Konfiguracja związana z dostarczaniem lokalnym kończy się w danym dniu. |
service_radius |
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 |
Godzina zakończenia dostawy lokalnej tego dnia. |
store_close_offset_hours |
Dotyczy tylko realizacji dostawy lokalnej. Reprezentuje ostateczny termin jako liczbę godzin do zamknięcia sklepu. Wzajemnie wyklucza się z: |
no_delivery_post_cutoff |
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 |
LocalCutoffTime
Godzina zakończenia dostawy lokalnej tego dnia.
Pola | |
---|---|
hour |
Zamówienia z dostawą lokalną muszą zostać złożone do tego dnia, aby mogły zostać przetworzone tego samego dnia. |
minute |
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 |
Identyfikator. Nazwa zasobu ustawienia dostawy. Format: |
services[] |
Opcjonalnie: Lista usług na koncie docelowym. |
warehouses[] |
Opcjonalnie: Lista magazynów, do których można się odwołać w: |
etag |
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:
|
Tabela
Tabela określająca grupę stawek, gdy single_value
nie jest wystarczająco ekspresyjny.
Pola | |
---|---|
rows[] |
Wymagane. Lista wierszy tworzących tabelę. Musi mieć taką samą długość jak |
name |
Nazwa tabeli. Wymagane w przypadku podtabel, ignorowane w przypadku głównej tabeli. |
row_headers |
Wymagane. Nagłówki wierszy w tabeli. |
column_headers |
Nagłówki kolumn tabeli. Opcjonalnie: jeśli zasada nie jest skonfigurowana, tabela zawiera tylko 1 wymiar. |
TermsOfService
TermsOfService
.
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu wersji warunków korzystania z usługi. Format: |
region_code |
Kod regionu określony przez CLDR. Wybierz kraj, w którym Warunki korzystania z usługi obowiązują konkretnie w tym kraju, lub |
kind |
Rodzaj, którego dotyczy ta wersja warunków korzystania z usługi. |
external |
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 |
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 |
Identyfikator. Nazwa zasobu wersji warunków korzystania z usługi. Format: |
region_code |
Kod regionu określony na stronie https://cldr.unicode.org/. To kraj, którego dotyczy bieżący stan. |
terms_of_service_kind |
Rodzaj Warunków korzystania z usługi powiązany z konkretną wersją. |
accepted |
Akceptowane warunki korzystania z tego rodzaju usługi oraz powiązany kod regionu |
required |
Wymagane warunki korzystania z usługi |
TermsOfServiceKind
Rodzaj Warunków 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[] |
Wymagane. Lista nazw regionów |
transit_time_labels[] |
Wymagane. Lista etykiet czasu przewozu. Ostatnia wartość może wynosić |
rows[] |
Wymagane. Jeśli występuje tylko 1 zbiór wymiarów o wartości |
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[] |
Wymagane. Zakres czasu przewozu (min.–maks.) w dniach roboczych. |
TransitTimeValue
Zakres czasu przewozu (min.–maks.) w dniach roboczych.
Pola | |
---|---|
min_transit_days |
Minimalny zakres czasu przewozu w dniach roboczych. 0 oznacza dostawę tego samego dnia, 1 oznacza dostawę następnego dnia. |
max_transit_days |
Wartość nie może być mniejsza niż |
UnclaimHomepageRequest
Komunikat żądania dla metody UnclaimHomepage
.
Pola | |
---|---|
name |
Wymagane. Nazwa strony głównej, do której chcesz usunąć prawa. Format: |
UpdateAccountRequest
Komunikat żądania dla metody UpdateAccount
.
Pola | |
---|---|
account |
Wymagane. Nowa wersja konta. |
update_mask |
Wymagane. Lista aktualizowanych pól. |
UpdateBusinessIdentityRequest
Komunikat żądania dla metody UpdateBusinessIdentity
.
Pola | |
---|---|
business_identity |
Wymagane. Nowa wersja tożsamości firmy. |
update_mask |
Wymagane. Lista aktualizowanych pól. |
UpdateBusinessInfoRequest
Komunikat żądania dla metody UpdateBusinessInfo
.
Pola | |
---|---|
business_info |
Wymagane. Nowa wersja informacji o firmie. |
update_mask |
Wymagane. Lista aktualizowanych pól. |
UpdateEmailPreferencesRequest
Prośba o wiadomość dotyczącą metody UpdateEmailPreferences.
Pola | |
---|---|
email_preferences |
Wymagane. Ustawienia powiadomień e-mail, które zostaną zaktualizowane. |
update_mask |
Wymagane. Lista aktualizowanych pól. |
UpdateHomepageRequest
Komunikat żądania dla metody UpdateHomepage
.
Pola | |
---|---|
homepage |
Wymagane. Nowa wersja strony głównej. |
update_mask |
Wymagane. Lista aktualizowanych pól. |
UpdateRegionRequest
Komunikat żądania dla metody UpdateRegion
.
Pola | |
---|---|
region |
Wymagane. Zaktualizowany region. |
update_mask |
Opcjonalnie: Rozdzielona przecinkami maska pola wskazująca pola do zaktualizowania. Przykład: |
UpdateUserRequest
Komunikat żądania dla metody UpdateUser
.
Pola | |
---|---|
user |
Wymagane. Nowa wersja konta użytkownika. Użyj |
update_mask |
Wymagane. Lista aktualizowanych pól. |
Użytkownik
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu użytkownika. Format: Użyj |
state |
Tylko dane wyjściowe. Stan użytkownika. |
access_rights[] |
Opcjonalnie: uprawnienia dostępu 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 został 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 |
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 |
Płaska stawka. Można go ustawić tylko wtedy, gdy nie ustawiono wszystkich innych pól. |
price_percentage |
Wartość procentowa ceny wyrażona w notacji dziesiętnej (np. |
carrier_rate |
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 |
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 |
Wymagane. Nazwa magazynu. Musi być niepowtarzalny w obrębie konta. |
shipping_address |
Wymagane. Adres dostawy magazynu. |
cutoff_time |
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 |
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 |
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 |
Wymagane. Operator, na przykład |
carrier_service |
Wymagane. Usługa przewoźnika, na przykład |
warehouse |
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 |
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 |
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. |