Package google.shopping.merchant.notifications.v1beta

Indeks

NotificationsApiService

Usługa do zarządzania subskrypcjami powiadomień dla sprzedawców

CreateNotificationSubscription

rpc CreateNotificationSubscription(CreateNotificationSubscriptionRequest) returns (NotificationSubscription)

Tworzy subskrypcję powiadomień dla sprzedawcy. Zezwalamy na jednoczesne tworzenie tych typów subskrypcji powiadomień (na sprzedawcę jako subskrybenta i typ zdarzenia): 1. Subskrypcja dla wszystkich kont zarządzanych + subskrypcja dla Ciebie 2. Wiele „częściowych” subskrypcji dla kont zarządzanych + subskrypcja dla siebie

nie będziemy zezwalać (na sprzedawcę jako subskrybenta na typ wydarzenia): 1. wiele subskrypcji własnych. 2. wiele subskrypcji na „wszystkich zarządzanych kontach”. 3. wszystkie lub częściowe subskrypcje w tym samym czasie. 4. wiele częściowych subskrypcji na to samo konto docelowe

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
DeleteNotificationSubscription

rpc DeleteNotificationSubscription(DeleteNotificationSubscriptionRequest) returns (Empty)

Usuwa subskrypcję powiadomień sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
GetNotificationSubscription

rpc GetNotificationSubscription(GetNotificationSubscriptionRequest) returns (NotificationSubscription)

Otrzymuje subskrypcje powiadomień z konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
ListNotificationSubscriptions

rpc ListNotificationSubscriptions(ListNotificationSubscriptionsRequest) returns (ListNotificationSubscriptionsResponse)

Otrzymuje wszystkie subskrypcje powiadomień sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.
UpdateNotificationSubscription

rpc UpdateNotificationSubscription(UpdateNotificationSubscriptionRequest) returns (NotificationSubscription)

Aktualizuje istniejącą subskrypcję powiadomień sprzedawcy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

Atrybut

Wartość Enum określająca atrybut w zasobie, który ulega zmianie, aby powiadomić sprzedawcę.

Wartości w polu enum
ATTRIBUTE_UNSPECIFIED Nieokreślony atrybut
STATUS Stan zmienionego elementu

CreateNotificationSubscriptionRequest

Komunikat żądania dla metody CreatePowiadomieniaSubscription.

Pola
parent

string

To pole jest wymagane. Konto sprzedawcy, do którego należy nowa subskrypcja powiadomień. Format: accounts/{account}
notification_subscription

NotificationSubscription

To pole jest wymagane. Subskrypcja powiadomień do utworzenia.

DeleteNotificationSubscriptionRequest

Komunikat żądania dotyczący metody Delete NotificationSubscription.

Pola
name

string

To pole jest wymagane. Nazwa subskrypcji powiadomień, która ma zostać usunięta.

GetNotificationSubscriptionRequest

Komunikat żądania dla metody GetPowiadomieniaSubscription.

Pola
name

string

To pole jest wymagane. Wartość name subskrypcji powiadomień.

ListNotificationSubscriptionsRequest

Komunikat żądania dla metody ListPowiadomieniaSubscription.

Pola
parent

string

To pole jest wymagane. Konto sprzedawcy, który jest właścicielem subskrypcji powiadomień. Format: accounts/{account}
page_size

int32

Maksymalna liczba subskrypcji powiadomień do zwrócenia na stronie. Wartość domyślna page_size wynosi 100. Maksymalna wartość to 200. Wartości powyżej 200 zostaną przekształcone na 200.
page_token

string

Token (jeśli został podany) pobierający kolejną stronę. Pozostałe parametry muszą odpowiadać oryginalnemu wywołaniu, które podało token strony.

ListNotificationSubscriptionsResponse

Komunikat z odpowiedzią dla metody ListPowiadomieniaSubscription.

Pola
notification_subscriptions[]

NotificationSubscription

Lista subskrypcji powiadomień, o którą prosi sprzedawca.
next_page_token

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.

NotificationSubscription

Reprezentuje subskrypcję powiadomień należącą do konta sprzedawcy.

Pola
name

string

Tylko dane wyjściowe. Wartość name konfiguracji powiadomień. Wygenerowane przez Content API po utworzeniu nowego elementu NotificationSubscription. Pole account to identyfikator sprzedawcy, który jest właścicielem konfiguracji. Format: accounts/{account}/notificationsubscriptions/{notification_subscription}
registered_event

NotificationEventType

Zdarzenie, o którym sprzedawca chce otrzymywać powiadomienia.
call_back_uri

string

Adres URL, który posłuży do przekazania powiadomienia sprzedawcy.

Pole sumy interested_in.

interested_in może być tylko jedną z tych wartości:
all_managed_accounts

bool

Jeśli ta wartość to prawda, konto, z którego wysłano prośbę, jest codziennie powiadamiane o konkretnym zdarzeniu w przypadku wszystkich kont zarządzanych (może to być subkont lub inne połączone konta), w tym nowo dodanych kont.
target_account

string

name konta, o którym chcesz otrzymywać powiadomienia. Format: accounts/{account}

NotificationEventType

Reprezentuje typ wydarzenia, o którym sprzedawca chce otrzymywać powiadomienia.

Wartości w polu enum
NOTIFICATION_EVENT_TYPE_UNSPECIFIED Typ zdarzenia dotyczącego powiadomień nie jest określony.
PRODUCT_STATUS_CHANGE Powiadomienie o zmianach stanu produktu, np. gdy zostanie on odrzucony.

ProductChange

Zmiana, jaka nastąpiła w usłudze, w tym starą i nową wartość oraz kod kraju jako kod regionu i kontekst raportowania.

Pola
old_value

string

Stara wartość zmienionego zasobu lub atrybutu.
new_value

string

Nowa wartość zmienionego zasobu lub atrybutu.
region_code

string

Kraje, w których wprowadzono zmianę (jeśli dotyczy)
reporting_context

ReportingContextEnum

Konteksty raportowania, w których wprowadzono zmianę (jeśli dotyczy)

ProductStatusChangeMessage

Wiadomość, którą sprzedawca otrzyma, aby poinformować o zdarzeniu zmiany stanu produktu

Pola
changes[]

ProductChange

Komunikat opisujący zmianę, która zaszła w usłudze
account

string

Konto docelowe, do którego należy element po zmianie. Format : accounts/{merchant_id}
managing_account

string

Konto, które zarządza kontem sprzedawcy. Może być takie samo jak identyfikator sprzedawcy, jeśli jest to samodzielne konto. Format : accounts/{service_provider_id}
resource_type

Resource

Zmieniony zasób. W tym przypadku będzie to zawsze Product.
attribute

Attribute

Zmieniony atrybut w zasobie. W tym przypadku będzie to zawsze Status.
resource_id

string

Identyfikator produktu.
resource

string

Nazwa produktu. Format: {product.name=accounts/{account}/products/{product}}

Zasób

Enum, aby określić zasób, o którym ma zostać powiadomiony sprzedawca.

Wartości w polu enum
RESOURCE_UNSPECIFIED Nieokreślony zasób
PRODUCT Typ zasobu : usługa

UpdateNotificationSubscriptionRequest

Komunikat żądania dla metody Update NotificationSubscription.

Pola
notification_subscription

NotificationSubscription

To pole jest wymagane. Nowa wersja subskrypcji powiadomień, którą należy zaktualizować.
update_mask

FieldMask

Lista aktualizowanych pól.