Package google.shopping.merchant.notifications.v1beta

Dizin

NotificationsApiService

Satıcılar için bildirim aboneliklerini yönetme hizmeti

CreateNotificationSubscription

rpc CreateNotificationSubscription(CreateNotificationSubscriptionRequest) returns (NotificationSubscription)

Bir işletme için bildirim aboneliği oluşturur. Bağımsız veya alt hesap hesapları için işletme kendi aboneliğini oluşturabilir. MCA'lar için işletme, tüm yönetilen hesaplar veya belirli bir alt hesap için abonelik oluşturabilir.

Aşağıdaki bildirim aboneliği türlerinin birlikte var olmasına izin vereceğiz (etkinlik türü başına abone olarak işletme başına):

  1. Tüm yönetilen hesaplar için abonelik + kendi hesabı için abonelik.

  2. Yönetilen hesaplar için birden fazla "kısmi" abonelik ve kendi hesabınıza abonelik.

Aşağıdakilere izin verilmez (etkinlik türü başına abone olarak işletme başına):

  1. Birden fazla kendi kendine abonelik.

  2. Birden fazla "tüm yönetilen hesaplar" aboneliği.

  3. "Tüm yönetilen hesaplar" aboneliği ve aynı anda kısmi abonelikler.

  4. Aynı hedef hesap için birden fazla kısmi abonelik.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
DeleteNotificationSubscription

rpc DeleteNotificationSubscription(DeleteNotificationSubscriptionRequest) returns (Empty)

Bir satıcının bildirim aboneliğini siler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
GetNotificationSubscription

rpc GetNotificationSubscription(GetNotificationSubscriptionRequest) returns (NotificationSubscription)

Bir hesap için bildirim aboneliklerini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
ListNotificationSubscriptions

rpc ListNotificationSubscriptions(ListNotificationSubscriptionsRequest) returns (ListNotificationSubscriptionsResponse)

Bir satıcının tüm bildirim aboneliklerini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.
UpdateNotificationSubscription

rpc UpdateNotificationSubscription(UpdateNotificationSubscriptionRequest) returns (NotificationSubscription)

Bir satıcının mevcut bildirim aboneliğini günceller.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleyi inceleyin.

Özellik

Satıcıyı bilgilendirmek için kaynakta değiştirilen özelliği belirtmek üzere kullanılan enum.

Sıralamalar
ATTRIBUTE_UNSPECIFIED Belirtilmemiş özellik
STATUS Değiştirilen öğenin durumu

CreateNotificationSubscriptionRequest

CreateNotificationSubscription yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Yeni bildirim aboneliğinin sahibi olan satıcı hesabı. Biçim: accounts/{account}
notification_subscription

NotificationSubscription

Zorunlu. Oluşturulacak bildirim aboneliği.

DeleteNotificationSubscriptionRequest

DeleteNotificationSubscription yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek bildirim aboneliğinin adı.

GetNotificationSubscriptionRequest

GetNotificationSubscription yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Bildirim aboneliğinin name.

ListNotificationSubscriptionsRequest

ListNotificationSubscription yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Bildirim aboneliklerinin sahibi olan satıcı hesabı. Biçim: accounts/{account}
page_size

int32

Bir sayfada döndürülecek maksimum bildirim aboneliği sayısı. page_size için varsayılan değer 100'dür. Maksimum değer 200'tür. 200'ün üzerindeki değerler 200 olarak zorlanacaktır.
page_token

string

Sonraki sayfayı almak için jeton (sağlanırsa). Diğer tüm parametreler, sayfa jetonunu sağlayan orijinal çağrıyla eşleşmelidir.

ListNotificationSubscriptionsResponse

ListNotificationSubscription yöntemi için yanıt mesajı.

Alanlar
notification_subscriptions[]

NotificationSubscription

Satıcı tarafından istenen bildirim aboneliklerinin listesi.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

NotificationSubscription

Satıcı hesabına ait bir bildirim aboneliğini temsil eder.

Alanlar
name

string

Yalnızca çıkış. Bildirim yapılandırmasının name değeri. Yeni bir NotificationSubscription oluşturulduğunda Content API tarafından oluşturulur. account, yapılandırmanın sahibi olan satıcının satıcı kimliğini temsil eder. Biçim: accounts/{account}/notificationsubscriptions/{notification_subscription}
registered_event

NotificationEventType

Satıcının bildirim almak istediği etkinlik.
call_back_uri

string

Bildirimi satıcıya göndermek için kullanılacak URL.

Birlik alanı interested_in.

interested_in yalnızca aşağıdakilerden biri olabilir:
all_managed_accounts

bool

Bu değer doğruysa istek gönderen hesap, yeni eklenen hesaplar da dahil olmak üzere tüm yönetilen hesaplar (alt hesaplar veya diğer bağlı hesaplar olabilir) için belirtilen etkinlik hakkında günlük olarak bilgilendirilir.
target_account

string

Bildirim almak istediğiniz hesabın name. Biçim: accounts/{account}

NotificationEventType

Satıcının bildirim almak istediği etkinlik türünü temsil eder.

Sıralamalar
NOTIFICATION_EVENT_TYPE_UNSPECIFIED Bildirimler etkinlik türü belirtilmedi.
PRODUCT_STATUS_CHANGE Ürün durumu değişiklikleri (ör. ürün onaylanmadığında) hakkında bildirim.

ProductChange

Eski değer, yeni değer, bölge kodu olarak ülke kodu ve raporlama bağlamı dahil olmak üzere üründe yapılan değişiklik.

Alanlar
old_value

string

Değiştirilen kaynağın veya özelliğin eski değeri.
new_value

string

Değiştirilen kaynağın veya özelliğin yeni değeri.
region_code

string

Değişikliğin geçerli olduğu ülkeler (varsa)
reporting_context

ReportingContextEnum

Değişiklik içeren raporlama bağlamları (varsa)

ProductStatusChangeMessage

Satıcının ürün durumu değişikliği etkinliği hakkında bilgilendirilmek için alacağı mesaj

Alanlar
changes[]

ProductChange

Üründe yapılan değişikliği açıklayan bir mesaj
account

string

Değişen öğenin sahibi olan hedef hesap. Biçim : accounts/{merchant_id}
managing_account

string

Satıcının hesabını yöneten hesap. Bağımsız hesapsa satıcı kimliğiyle aynı olabilir. Biçim : accounts/{service_provider_id}
resource_type

Resource

Değişen kaynak. Bu durumda her zaman Product olur.
attribute

Attribute

Kaynakta değişen özellik. Bu durumda her zaman Status olur.
resource_id

string

Ürün kimliği.
resource

string

Ürün adı. Biçim: {product.name=accounts/{account}/products/{product}}
expiration_time

Timestamp

Ürünün geçerlilik bitiş zamanı. Bildirim, ürün silme etkinliği için gönderilirse bu alan ayarlanmaz.

Kaynak

Satıcıyı bilgilendirmek için değiştirilen kaynağı belirtmek üzere kullanılan enum.

Sıralamalar
RESOURCE_UNSPECIFIED Belirtilmemiş kaynak
PRODUCT Kaynak türü : ürün

UpdateNotificationSubscriptionRequest

UpdateNotificationSubscription yöntemi için istek mesajı.

Alanlar
notification_subscription

NotificationSubscription

Zorunlu. Güncellenmesi gereken bildirim aboneliğinin yeni sürümü.
update_mask

FieldMask

Güncellenen alanların listesi.