Package google.shopping.merchant.notifications.v1beta

Chỉ mục

NotificationsApiService

Dịch vụ quản lý gói thuê bao nhận thông báo dành cho người bán

CreateNotificationSubscription

rpc CreateNotificationSubscription(CreateNotificationSubscriptionRequest) returns (NotificationSubscription)

Tạo gói thuê bao thông báo cho người bán. Chúng tôi cho phép các loại thông báo sau đây được đăng ký sử dụng cùng nhau (mỗi người bán là người đăng ký đối với mỗi loại sự kiện): 1. Gói thuê bao cho tất cả tài khoản được quản lý + gói thuê bao cho chính bạn. Nhiều gói thuê bao "một phần" cho tài khoản được quản lý + gói thuê bao cho bản thân

chúng tôi sẽ không cho phép (đối với mỗi người bán là người đăng ký đối với mỗi loại sự kiện): 1. nhiều tự đăng ký. 2. nhiều gói thuê bao "tất cả tài khoản được quản lý". 3. toàn bộ và một phần gói thuê bao cùng lúc. 4. nhiều gói thuê bao một phần cho cùng một tài khoản đích

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
DeleteNotificationSubscription

rpc DeleteNotificationSubscription(DeleteNotificationSubscriptionRequest) returns (Empty)

Xoá gói thuê bao thông báo cho người bán.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
GetNotificationSubscription

rpc GetNotificationSubscription(GetNotificationSubscriptionRequest) returns (NotificationSubscription)

Nhận các lượt đăng ký nhận thông báo cho một tài khoản.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
ListNotificationSubscriptions

rpc ListNotificationSubscriptions(ListNotificationSubscriptionsRequest) returns (ListNotificationSubscriptionsResponse)

Xem tất cả các thông báo đã đăng ký nhận cho người bán.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
UpdateNotificationSubscription

rpc UpdateNotificationSubscription(UpdateNotificationSubscriptionRequest) returns (NotificationSubscription)

Cập nhật gói thuê bao thông báo hiện tại cho người bán.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

Thuộc tính

Enum để chỉ định thuộc tính trong tài nguyên đang được thay đổi để thông báo cho người bán.

Enum
ATTRIBUTE_UNSPECIFIED Thuộc tính chưa được chỉ định
STATUS Trạng thái của thực thể đã thay đổi

CreateNotificationSubscriptionRequest

Thông báo yêu cầu đối với phương thức CreateNotificationSubscription.

Trường
parent

string

Bắt buộc. Tài khoản người bán sở hữu gói thuê bao thông báo mới. Định dạng accounts/{account}
notification_subscription

NotificationSubscription

Bắt buộc. Gói thuê bao thông báo sẽ được tạo.

DeleteNotificationSubscriptionRequest

Thông báo yêu cầu cho phương thức DeleteNotificationSubscription.

Trường
name

string

Bắt buộc. Tên của gói thuê bao thông báo sẽ bị xoá.

GetNotificationSubscriptionRequest

Thông báo yêu cầu cho phương thức GetNotificationSubscription.

Trường
name

string

Bắt buộc. name của gói thuê bao thông báo.

ListNotificationSubscriptionsRequest

Thông báo yêu cầu cho phương thức ListNotificationSubscription.

Trường
parent

string

Bắt buộc. Tài khoản người bán sở hữu các gói thuê bao thông báo. Định dạng accounts/{account}
page_size

int32

Số lượt đăng ký nhận thông báo tối đa trên một trang. Giá trị mặc định của page_size là 100. Giá trị tối đa là 200. Các giá trị trên 200 sẽ được ép gán thành 200.
page_token

string

Mã thông báo (nếu được cung cấp) để truy xuất trang tiếp theo. Tất cả các thông số khác phải khớp với lệnh gọi ban đầu đã cung cấp mã thông báo trang.

ListNotificationSubscriptionsResponse

Thông báo phản hồi cho phương thức ListNotificationSubscription.

Trường
notification_subscriptions[]

NotificationSubscription

Danh sách các gói đăng ký nhận thông báo mà người bán yêu cầu.
next_page_token

string

Mã thông báo này có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì không có trang tiếp theo nào.

NotificationSubscription

Đại diện cho đăng ký thông báo do tài khoản người bán sở hữu.

Trường
name

string

Chỉ có đầu ra. name của cấu hình thông báo. Do Content API tạo khi tạo NotificationSubscription mới. account đại diện cho mã người bán của người bán sở hữu cấu hình. Định dạng: accounts/{account}/notificationsubscriptions/{notification_subscription}
registered_event

NotificationEventType

Sự kiện mà người bán muốn được thông báo.
call_back_uri

string

URL được dùng để đẩy thông báo đến người bán.

Trường hợp interested_in.

interested_in chỉ có thể là một trong những trạng thái sau:
all_managed_accounts

bool

Nếu giá trị này đúng, tài khoản đưa ra yêu cầu sẽ nhận được thông báo về sự kiện được chỉ định cho tất cả các tài khoản được quản lý (có thể là tài khoản phụ hoặc tài khoản được liên kết khác), bao gồm cả những tài khoản mới được thêm vào hằng ngày.
target_account

string

name của tài khoản mà bạn muốn nhận thông báo. Định dạng: accounts/{account}

NotificationEventType

Thể hiện loại sự kiện mà người bán muốn nhận thông báo.

Enum
NOTIFICATION_EVENT_TYPE_UNSPECIFIED Chưa xác định loại sự kiện thông báo.
PRODUCT_STATUS_CHANGE Thông báo về việc thay đổi trạng thái sản phẩm, chẳng hạn như khi sản phẩm bị từ chối.

ProductChange

Thay đổi đã xảy ra với sản phẩm, bao gồm cả giá trị cũ, giá trị mới, mã quốc gia dưới dạng mã vùng và ngữ cảnh báo cáo.

Trường
old_value

string

Giá trị cũ của tài nguyên hoặc thuộc tính đã thay đổi.
new_value

string

Giá trị mới của tài nguyên hoặc thuộc tính đã thay đổi.
region_code

string

Các quốc gia có thay đổi này (nếu có)
reporting_context

ReportingContextEnum

Các ngữ cảnh báo cáo có thay đổi (nếu có)

ProductStatusChangeMessage

Thông báo mà người bán sẽ nhận được để thông báo về sự kiện thay đổi trạng thái sản phẩm

Trường
changes[]

ProductChange

Thông báo để mô tả thay đổi đã xảy ra với sản phẩm
account

string

Tài khoản đích sở hữu thực thể đã thay đổi. Định dạng : accounts/{merchant_id}
managing_account

string

Tài khoản quản lý tài khoản của người bán có thể giống với mã người bán nếu là tài khoản độc lập. Định dạng : accounts/{service_provider_id}
resource_type

Resource

Tài nguyên đã thay đổi, trong trường hợp này sẽ luôn là Product.
attribute

Attribute

Thuộc tính trong tài nguyên đã thay đổi. Trong trường hợp này, thuộc tính sẽ luôn là Status.
resource_id

string

Mã sản phẩm.
resource

string

Tên sản phẩm. Định dạng {product.name=accounts/{account}/products/{product}}

Tài nguyên

Enum để chỉ định tài nguyên đang được thay đổi nhằm thông báo cho người bán.

Enum
RESOURCE_UNSPECIFIED Tài nguyên không xác định
PRODUCT Loại tài nguyên : sản phẩm

UpdateNotificationSubscriptionRequest

Thông báo yêu cầu cho phương thức UpdateNotificationSubscription.

Trường
notification_subscription

NotificationSubscription

Bắt buộc. Phiên bản mới của gói thuê bao nhận thông báo cần được cập nhật.
update_mask

FieldMask

Danh sách trường đang được cập nhật.