索引
LoyaltyClassService
(介面)LoyaltyObjectService
(介面)LoyaltyClass
(訊息)LoyaltyClassAddMessageRequest
(訊息)LoyaltyClassAddMessageResponse
(訊息)LoyaltyClassGetRequest
(訊息)LoyaltyClassInsertRequest
(訊息)LoyaltyClassListRequest
(訊息)LoyaltyClassListResponse
(訊息)LoyaltyClassPatchRequest
(訊息)LoyaltyClassUpdateRequest
(訊息)LoyaltyObject
(訊息)LoyaltyObjectAddMessageRequest
(訊息)LoyaltyObjectAddMessageResponse
(訊息)LoyaltyObjectGetRequest
(訊息)LoyaltyObjectInsertRequest
(訊息)LoyaltyObjectListRequest
(訊息)LoyaltyObjectListResponse
(訊息)LoyaltyObjectModifyLinkedOfferObjectsRequest
(訊息)LoyaltyObjectPatchRequest
(訊息)LoyaltyObjectUpdateRequest
(訊息)LoyaltyPoints
(訊息)LoyaltyPointsBalance
(訊息)
LoyaltyClassService
AddMessage | |
---|---|
新增訊息至指定類別 ID 參照的會員類別。
|
Get | |
---|---|
傳回具有指定類別 ID 的會員類別。
|
Insert | |
---|---|
插入具有指定 ID 和屬性的會員類別。
|
List | |
---|---|
傳回指定核發機構 ID 的所有會員類別清單。
|
Patch | |
---|---|
更新指定類別 ID 參照的會員類別。這個方法支援 patch 語意。
|
Update | |
---|---|
更新指定類別 ID 參照的會員類別。
|
LoyaltyObjectService
AddMessage | |
---|---|
新增訊息至指定物件 ID 參照的會員物件。
|
Get | |
---|---|
傳回具有指定物件 ID 的會員物件。
|
Insert | |
---|---|
插入具有指定 ID 和屬性的會員物件。
|
List | |
---|---|
傳回指定核發機構 ID 的所有會員物件清單。
|
ModifyLinkedOfferObjects | |
---|---|
針對具有指定 ID 的會員物件,修改已連結的優惠物件。
|
Patch | |
---|---|
更新指定物件 ID 參照的會員物件。這個方法支援 patch 語意。
|
Update | |
---|---|
更新指定物件 ID 參照的會員物件。
|
LoyaltyClass
欄位 | |
---|---|
kind |
表示資源的種類。值:固定字串 |
program_name |
必要項目。方案名稱,例如「小明服飾店」。應用程式可能會在前 20 個字元之後顯示省略符號,以確保在較小的螢幕上可顯示完整字串。 |
program_logo |
必要項目。會員方案或公司的標誌。這個標誌會顯示在應用程式的詳細資料及清單檢視畫面中。 |
account_name_label |
帳戶名稱標籤,例如「會員名稱」。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
account_id_label |
帳戶 ID 標籤,例如「會員 ID」。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
rewards_tier_label |
獎勵級別標籤,例如「獎勵級別」。建議長度上限為 9 個字元,以確保在較小的螢幕上可顯示完整字串。 |
rewards_tier |
獎勵級別,例如「爍金」或「白金」。建議長度上限為 7 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localized_program_name |
program_name 的翻譯字串。應用程式可能會在前 20 個字元之後顯示省略符號,以確保在較小的螢幕上可顯示完整字串。 |
localized_account_name_label |
account_name_label 的翻譯字串。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localized_account_id_label |
account_id_label 的翻譯字串。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localized_rewards_tier_label |
rewards_tier_label 的翻譯字串。建議長度上限為 9 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localized_rewards_tier |
rewards_tier 的翻譯字串。建議長度上限為 7 個字元,以確保在較小的螢幕上可顯示完整字串。 |
secondary_rewards_tier_label |
次要獎勵級別標籤,例如「獎勵級別」。 |
localized_secondary_rewards_tier_label |
secondary_rewards_tier_label 的翻譯字串。 |
secondary_rewards_tier |
次要獎勵級別,例如「爍金」或「白金」。 |
localized_secondary_rewards_tier |
secondary_rewards_tier 的翻譯字串。 |
discoverable_program |
如何在 Google Pay 應用程式中探索類別及將類別例項化的相關資訊。 |
class_template_info |
類別顯示方式的範本資訊。如未設定,Google 會恢復為顯示一組預設的欄位。 |
id |
必要項目。類別的專屬 ID。特定核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
version |
已淘汰 |
issuer_name |
必要項目。發卡機構名稱。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。 |
allow_multiple_users_per_object |
已淘汰,請改用 |
homepage_uri |
應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (顯示物件時,首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。 |
locations[] |
可以使用物件的位置清單。平台會使用這項資訊以觸發向使用者顯示的地理位置通知。請注意,物件中的位置會覆寫類別中的位置,類別中的位置會覆寫 Google 地方資訊 ID 中的位置。 |
review_status |
必要項目。類別的狀態。可以透過 insert、patch 或 update 的 API 呼叫,將這個欄位設定為 當類別處於發展階段時,這個欄位應保持為 如果您確認類別可供使用,則應將此欄位設為 更新已處於 |
review |
當類別被標示為 |
info_module_data |
已淘汰,請改用 textModulesData。 |
image_modules_data[] |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
text_modules_data[] |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個,以及來自類別的 10 個。 |
links_module_data |
連結模組資料。如果物件中也定義了連結模組資料,則兩項資料都會顯示。 |
redemption_issuers[] |
僅適用於支援智慧感應功能的合作夥伴。如需其他協助,請聯絡支援小組。 |
country_code |
國家/地區代碼,用於顯示卡片的國家/地區 (當使用者不在該國家/地區時),以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。 |
hero_image |
顯示在卡片正面的選用橫幅圖片。如果未提供,就不會顯示任何圖片。圖片會以 100% 寛度顯示。 |
word_mark |
已淘汰。 |
enable_smart_tap |
僅適用於支援智慧感應功能的合作夥伴。如需其他協助,請聯絡支援小組。 |
hex_background_color |
卡片的背景顏色。如果未設定,將會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,將會使用標誌的主要顏色。格式為 #rrggbb,其中 rrggbb 是採十六進位制的 RGB 三元組,例如 |
localized_issuer_name |
issuer_name 的翻譯字串。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
multiple_devices_and_holders_allowed_status |
表示是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。 |
callback_options |
每當使用者儲存/刪除這個類別的物件時,可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼功能。 |
LoyaltyClassAddMessageRequest
欄位 | |
---|---|
resource_id |
類別的專屬 ID。特定核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
add_message_request |
要求的內容。 |
LoyaltyClassAddMessageResponse
欄位 | |
---|---|
resource |
更新的 LoyaltyClass 資源。 |
LoyaltyClassGetRequest
欄位 | |
---|---|
resource_id |
類別的專屬 ID。特定核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
LoyaltyClassInsertRequest
欄位 | |
---|---|
resource |
要求的內容。 |
LoyaltyClassListRequest
欄位 | |
---|---|
issuer_id |
獲授權可列出類別的核發機構 ID。 |
token |
如有指定 |
max_results |
表示清單傳回的結果數量上限。如未定義 |
LoyaltyClassListResponse
欄位 | |
---|---|
resources[] |
與清單要求相對應的資源。 |
pagination |
回應的分頁。 |
LoyaltyClassPatchRequest
欄位 | |
---|---|
resource_id |
類別的專屬 ID。特定核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
resource |
要求的內容。 |
LoyaltyClassUpdateRequest
欄位 | |
---|---|
resource_id |
類別的專屬 ID。特定核發機構的所有類別 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
resource |
要求的內容。 |
LoyaltyObject
欄位 | |
---|---|
kind |
表示資源的種類。值:固定字串 |
class_reference |
父項類別的沿用欄位副本。這類欄位是在 GET 執行期間擷取的。 |
account_name |
會員帳戶持有人名稱,例如「王大明」。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
account_id |
會員帳戶 ID。建議長度上限為 20 個字元。 |
loyalty_points |
會員獎勵點數標籤、餘額和類型。 |
linked_offer_ids[] |
與這張會員卡相連結的優惠物件清單。優惠物件必須已存在。 優惠物件 ID 應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。 |
secondary_loyalty_points |
次要會員獎勵點數標籤、餘額和類型,會與主要會員點數一併顯示。 |
id |
必要項目。物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
class_id |
必要項目。與這個物件相關聯的類別,必須是與這個物件同類型、已存在,並且經過核准的類別。 類別 ID 應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。 |
version |
已淘汰 |
state |
必要項目。物件的狀態。您可以使用這個欄位來設定物件在應用程式中的顯示情形。舉例來說, |
barcode |
條碼類型和值。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。 |
valid_time_interval |
這個物件處於 |
locations[] |
可以使用物件的位置清單。平台會使用這項資訊以觸發向使用者顯示的地理位置通知。請注意,物件中的位置會覆寫類別中的位置,類別中的位置會覆寫 Google 地方資訊 ID 中的位置。 |
has_users |
表示這個物件是否有使用者。這個欄位是由平台所設定。 |
smart_tap_redemption_value |
僅適用於支援智慧感應功能的合作夥伴。如需其他協助,請聯絡支援小組。 |
has_linked_device |
表示這個物件目前是否已連結至某部裝置。當使用者儲存物件以將物件連結到裝置時,平台會設定這個欄位。適用於特定合作夥伴。詳情請聯絡支援小組。 |
disable_expiration_notification |
表示是否應明確封鎖通知。如果將這個欄位設為 true,無論 目前此項目只能針對優惠進行設定。 |
info_module_data |
已淘汰,請改用 textModulesData。 |
image_modules_data[] |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
text_modules_data[] |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個,以及來自類別的 10 個。 |
links_module_data |
連結模組資料。如果類別中也定義了連結模組資料,則兩項資料都會顯示。 |
app_link_data |
合作夥伴應用程式連結的相關資訊 (選擇性)。 |
LoyaltyObjectAddMessageRequest
欄位 | |
---|---|
resource_id |
物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
add_message_request |
要求的內容。 |
LoyaltyObjectAddMessageResponse
欄位 | |
---|---|
resource |
更新的 LoyaltyObject 資源。 |
LoyaltyObjectGetRequest
欄位 | |
---|---|
resource_id |
物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
LoyaltyObjectInsertRequest
欄位 | |
---|---|
resource |
要求的內容。 |
LoyaltyObjectListRequest
欄位 | |
---|---|
class_id |
要列出其物件的類別 ID。 |
token |
如有指定 |
max_results |
表示清單傳回的結果數量上限。如未定義 |
LoyaltyObjectListResponse
欄位 | |
---|---|
resources[] |
與清單要求相對應的資源。 |
pagination |
回應的分頁。 |
LoyaltyObjectModifyLinkedOfferObjectsRequest
欄位 | |
---|---|
resource_id |
物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
modify_linked_offer_objects_request |
會員物件的優惠物件 ID。 |
LoyaltyObjectPatchRequest
欄位 | |
---|---|
resource_id |
物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
resource |
要求的內容。 |
LoyaltyObjectUpdateRequest
欄位 | |
---|---|
resource_id |
物件的專屬 ID。特定核發機構的所有物件 ID 都不得重複。這個值應依循 issuer ID.identifier 的格式,其中前者是由 Google 核發,後者則由你指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
resource |
要求的內容。 |
LoyaltyPoints
欄位 | |
---|---|
label |
會員點數標籤,例如「點數」。建議長度上限為 9 個字元。 |
balance |
帳戶持有人的會員點數餘額,例如「500」或「$10.00 美元」。建議長度上限為 7 個字元。這是 |
localized_label |
標籤的翻譯字串。建議長度上限為 9 個字元。 |
LoyaltyPointsBalance
欄位 | |
---|---|
string |
餘額的字串形式。string、int、double 和 money 這四種子類型只能擇一填入。 |
int |
餘額的整數形式。string、int、double 和 money 這四種子類型只能擇一填入。 |
double |
餘額的雙精度浮點數形式。string、int、double 和 money 這四種子類型只能擇一填入。 |
money |
餘額的金額形式。string、int、double 和 money 這四種子類型只能擇一填入。 |