google.walletobjects.v1.offer 套件

索引

OfferClassService

AddMessage

rpc AddMessage(OfferClassAddMessageRequest) returns (OfferClassAddMessageResponse)

在指定類別 ID 參照的優惠類別中新增訊息。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferClassGetRequest) returns (OfferClass)

傳回具有指定類別 ID 的優惠類別。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferClassInsertRequest) returns (OfferClass)

插入具有指定 ID 和屬性的優惠類別。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferClassListRequest) returns (OfferClassListResponse)

傳回指定核發機構 ID 的所有優惠類別清單。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferClassPatchRequest) returns (OfferClass)

更新指定類別 ID 參照的優惠類別。這個方法支援 patch 語義。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferClassUpdateRequest) returns (OfferClass)

更新指定類別 ID 參照的優惠類別。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferObjectService

AddMessage

rpc AddMessage(OfferObjectAddMessageRequest) returns (OfferObjectAddMessageResponse)

新增訊息至指定物件 ID 參照的優惠物件。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Get

rpc Get(OfferObjectGetRequest) returns (OfferObject)

傳回具有指定物件 ID 的優惠物件。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Insert

rpc Insert(OfferObjectInsertRequest) returns (OfferObject)

插入具有指定 ID 和屬性的優惠物件。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
List

rpc List(OfferObjectListRequest) returns (OfferObjectListResponse)

傳回指定核發機構 ID 的所有優惠物件清單。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Patch

rpc Patch(OfferObjectPatchRequest) returns (OfferObject)

更新指定物件 ID 參照的優惠物件。這個方法支援 patch 語義。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer
Update

rpc Update(OfferObjectUpdateRequest) returns (OfferObject)

更新指定物件 ID 參照的優惠物件。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/wallet_object.issuer

OfferClass

欄位
kind
(deprecated)

string

表示資源的種類。值：固定字串 "walletobjects#offerClass"。
title

string

必要項目。優惠的標題，例如「所有 T 恤皆可享 8 折優惠」。建議長度上限為 60 個字元，以確保在較小的螢幕上可顯示完整字串。
redemption_channel

RedemptionChannel

必要項目。適用於這項優惠的兌換管道。
provider

string

必要項目。優惠的提供者 (集結網站名稱或商家名稱)。建議長度上限為 12 個字元，以確保在較小的螢幕上可顯示完整字串。
title_image

Image

優惠的標題圖片。這張圖片會顯示在應用程式的詳細資料及清單檢視畫面中。
details

string

優惠詳細資料。
fine_print

string

優惠的附屬細則或條款，例如「購買任何小明服飾店的 T 恤可享 8 折優惠」。
help_uri

Uri

優惠的說明連結，例如：http://myownpersonaldomain.com/help
localized_title

LocalizedString

標題的翻譯字串。建議長度上限為 60 個字元，以確保在較小的螢幕上可顯示完整字串。
localized_provider

LocalizedString

提供者的翻譯字串。建議長度上限為 12 個字元，以確保在較小的螢幕上可顯示完整字串。
localized_details

LocalizedString

詳細資料的翻譯字串。
localized_fine_print

LocalizedString

fine_print 的翻譯字串。
short_title

string

優惠的短版標題 (例如「8 折優惠」)，方便使用者快速瞭解優惠內容。建議長度上限為 20 個字元。
localized_short_title

LocalizedString

短版標題的翻譯字串。建議長度上限為 20 個字元。
class_template_info

ClassTemplateInfo

類別顯示方式的範本資訊。如未設定，Google 會恢復為顯示一組預設的欄位。
id

string

必要項目。類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
version
(deprecated)

int64

已淘汰
issuer_name

string

必要項目。發卡機構名稱。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
messages[]

Message

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。
allow_multiple_users_per_object
(deprecated)

bool

已淘汰，請改用 multipleDevicesAndHoldersAllowedStatus。
homepage_uri

Uri

應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (顯示物件時，首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。
locations[]

LatLongPoint

可以使用物件的位置清單。平台會使用這項資訊以觸發向使用者顯示的地理位置通知。請注意，物件中的位置會覆寫類別中的位置，類別中的位置會覆寫 Google 地方資訊 ID 中的位置。
review_status

ReviewStatus

必要項目。類別的狀態。此欄位可以設定為 draft 或類別的狀態。可以透過 insert、patch 或 update 的 API 呼叫，將這個欄位設定為 draft 或 underReview。一但審查狀態從 draft 變更為其他狀態，就無法再變回 draft。

當類別處於發展階段時，這個欄位應保持為 draft。draft 類別無法用於建立任何物件。

如果您確認類別可供使用，則應將此欄位設為 underReview。平台會自動將此欄位設為 approved，這樣就能立即用以建立或遷移物件。

更新已處於 approved 的類別時，請繼續將這個欄位設為 underReview。
review

Review

當類別被標示為 approved 或 rejected 時，平台所設定的審查留言。
info_module_data
(deprecated)

InfoModuleData

已淘汰，請改用 textModulesData。
image_modules_data[]

ImageModuleData

圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個，以及類別物件層級 1 個。
text_modules_data[]

TextModuleData

文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個，以及來自類別的 10 個。
redemption_issuers[]

int64

僅適用於支援智慧感應功能的合作夥伴。如需其他協助，請聯絡支援小組。
country_code

string

國家/地區代碼，用於顯示卡片的國家/地區 (當使用者不在該國家/地區時)，以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。
hero_image

Image

顯示在卡片正面的選用橫幅圖片。如果未提供，就不會顯示任何圖片。圖片會以 100% 寛度顯示。
word_mark
(deprecated)

Image

已淘汰。
enable_smart_tap

bool

僅適用於支援智慧感應功能的合作夥伴。如需其他協助，請聯絡支援小組。
hex_background_color

string

卡片的背景顏色。如果未設定，將會使用主頁橫幅的主要顏色；如果未設定主頁橫幅，將會使用標誌的主要顏色。格式為 #rrggbb，其中 rrggbb 是採十六進位制的 RGB 三元組，例如 #ffcc00。您也可以使用 RGB 三元組的簡寫版本 #rgb，例如 #fc0。
localized_issuer_name

LocalizedString

issuer_name 的翻譯字串。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
multiple_devices_and_holders_allowed_status

MultipleDevicesAndHoldersAllowedStatus

表示是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。
callback_options

CallbackOptions

每當使用者儲存/刪除這個類別的物件時，可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼功能。

RedemptionChannel

列舉
REDEMPTION_CHANNEL_UNSPECIFIED
INSTORE
instore

INSTORE 的舊版別名，已淘汰。
ONLINE
online

ONLINE 的舊版別名，已淘汰。
BOTH
both

BOTH 的舊版別名，已淘汰。
TEMPORARY_PRICE_REDUCTION
temporaryPriceReduction

TEMPORARY_PRICE_REDUCTION 的舊版別名，已淘汰。

OfferClassAddMessageRequest

欄位
resource_id

string

類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
add_message_request

AddMessageRequest

要求的內容。

OfferClassAddMessageResponse

欄位
resource

OfferClass

更新的 OfferClass 資源。

OfferClassGetRequest

欄位
resource_id

string

類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。

OfferClassInsertRequest

欄位
resource

OfferClass

要求的內容。

OfferClassListRequest

欄位
issuer_id

int64

獲授權可列出類別的核發機構 ID。
token

string

如有指定 maxResults，但清單中的類別數量超過 maxResults，則可使用這個項目取得下一組結果。舉例來說，如果您有包含 200 個類別的清單，且您在呼叫清單時 maxResults 是設為 20，清單則會傳回前 20 個類別和一個符記。只要在 maxResults 設為 20 的情況下使用符記再次呼叫清單，即可取得接下來的 20 個類別。
max_results

int32

表示清單傳回的結果數量上限。如未定義 maxResults，則會傳回所有結果。

OfferClassListResponse

欄位
resources[]

OfferClass

與清單要求相對應的資源。
pagination

Pagination

回應的分頁。

OfferClassPatchRequest

欄位
resource_id

string

類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
resource

OfferClass

要求的內容。

OfferClassUpdateRequest

欄位
resource_id

string

類別的專屬 ID。核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
resource

OfferClass

要求的內容。

OfferObject

欄位
kind
(deprecated)

string

表示資源的種類。值：固定字串 "walletobjects#offerObject"。
class_reference

OfferClass

父項類別的沿用欄位副本。這類欄位是在 GET 執行期間所擷取。
id

string

必要項目。物件的專屬 ID。核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
class_id

string

必要項目。與這個物件相關聯的類別，必須是與這個物件同類型、已存在，並且經過核准的類別。

類別 ID 應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。
version
(deprecated)

int64

已淘汰
state

State

必要項目。物件的狀態。您可以使用這個欄位來設定物件在應用程式中的顯示情形。舉例來說，inactive 物件會移至「過期的票證」區段。
barcode

Barcode

條碼類型和值。
messages[]

Message

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。
valid_time_interval

TimeInterval

這個物件處於 active 狀態且可供使用的時間範圍。如果過了這段時間範圍，物件的狀態會變成 expired。
locations[]

LatLongPoint

可以使用物件的位置清單。平台會使用這項資訊以觸發向使用者顯示的地理位置通知。請注意，物件中的位置會覆寫類別中的位置，類別中的位置會覆寫 Google 地方資訊 ID 中的位置。
has_users

bool

表示這個物件是否有使用者。這個欄位是由平台所設定。
smart_tap_redemption_value

string

僅適用於支援智慧感應功能的合作夥伴。如需其他協助，請聯絡支援小組。
has_linked_device

bool

表示這個物件目前是否已連結至某部裝置。當使用者儲存物件以將物件連結到裝置時，平台會設定這個欄位。適用於特定合作夥伴。詳情請聯絡支援小組。
disable_expiration_notification

bool

表示是否應明確封鎖通知。如果將這個欄位設為 true，無論 messages 欄位的值為何，向使用者發出的到期通知都會遭封鎖。根據預設，這個欄位是設為 false。

目前此項目只能針對優惠進行設定。
info_module_data

InfoModuleData

已淘汰，請改用 textModulesData。
image_modules_data[]

ImageModuleData

圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個，以及類別物件層級 1 個。
text_modules_data[]

TextModuleData

文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個，以及來自類別的 10 個。

OfferObjectAddMessageRequest

欄位
resource_id

string

物件的專屬 ID。核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
add_message_request

AddMessageRequest

要求的內容。

OfferObjectAddMessageResponse

欄位
resource

OfferObject

更新的 OfferObject 資源。

OfferObjectGetRequest

欄位
resource_id

string

物件的專屬 ID。核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。

OfferObjectInsertRequest

欄位
resource

OfferObject

要求的內容。

OfferObjectListRequest

欄位
class_id

string

要列出其物件的類別 ID。
token

string

如有指定 maxResults，但清單中的物件數量超過 maxResults，則可使用這個項目取得下一組結果。舉例來說，如果您有包含 200 個物件的清單，且您在呼叫清單時 maxResults 是設為 20，則清單會傳回前 20 個物件和一個符記。只要在 maxResults 設為 20 的情況下使用符記再次呼叫清單，即可取得接下來的 20 個物件。
max_results

int32

表示清單傳回的結果數量上限。如未定義 maxResults，則會傳回所有結果。

OfferObjectListResponse

欄位
resources[]

OfferObject

與清單要求相對應的資源。
pagination

Pagination

回應的分頁。

OfferObjectPatchRequest

欄位
resource_id

string

物件的專屬 ID。核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
resource

OfferObject

要求的內容。

OfferObjectUpdateRequest

欄位
resource_id

string

物件的專屬 ID。核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
resource

OfferObject

要求的內容。