本頁面由 Cloud Translation API 翻譯而成。

REST Resource: giftcardclass

資源：GiftCardClass
- JSON 表示法
方法

資源：GiftCardClass

JSON 表示法

JSON 表示法
{ "kind": string, "merchantName": string, "programLogo": { object (`Image`) }, "pinLabel": string, "eventNumberLabel": string, "allowBarcodeRedemption": boolean, "localizedMerchantName": { object (`LocalizedString`) }, "localizedPinLabel": { object (`LocalizedString`) }, "localizedEventNumberLabel": { object (`LocalizedString`) }, "cardNumberLabel": string, "localizedCardNumberLabel": { object (`LocalizedString`) }, "classTemplateInfo": { object (`ClassTemplateInfo`) }, "id": string, "version": string, "issuerName": string, "messages": [ { object (`Message`) } ], "allowMultipleUsersPerObject": boolean, "homepageUri": { object (`Uri`) }, "locations": [ { object (`LatLongPoint`) } ], "reviewStatus": enum (`ReviewStatus`), "review": { object (`Review`) }, "infoModuleData": { object (`InfoModuleData`) }, "imageModulesData": [ { object (`ImageModuleData`) } ], "textModulesData": [ { object (`TextModuleData`) } ], "linksModuleData": { object (`LinksModuleData`) }, "redemptionIssuers": [ string ], "countryCode": string, "heroImage": { object (`Image`) }, "wordMark": { object (`Image`) }, "enableSmartTap": boolean, "hexBackgroundColor": string, "localizedIssuerName": { object (`LocalizedString`) }, "multipleDevicesAndHoldersAllowedStatus": enum (`MultipleDevicesAndHoldersAllowedStatus`), "callbackOptions": { object (`CallbackOptions`) }, "securityAnimation": { object (`SecurityAnimation`) }, "viewUnlockRequirement": enum (`ViewUnlockRequirement`), "wideProgramLogo": { object (`Image`) }, "appLinkData": { object (`AppLinkData`) } }

{
  "kind": string,
  "merchantName": string,
  "programLogo": {
    object (Image)
  },
  "pinLabel": string,
  "eventNumberLabel": string,
  "allowBarcodeRedemption": boolean,
  "localizedMerchantName": {
    object (LocalizedString)
  },
  "localizedPinLabel": {
    object (LocalizedString)
  },
  "localizedEventNumberLabel": {
    object (LocalizedString)
  },
  "cardNumberLabel": string,
  "localizedCardNumberLabel": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideProgramLogo": {
    object (Image)
  },
  "appLinkData": {
    object (AppLinkData)
  }
}

欄位
`kind (deprecated)`	`string` 這個項目已遭淘汰！標示資源的種類。值：固定字串 `"walletobjects#giftCardClass"`。
`merchantName`	`string` 商家名稱，例如「小明服飾店」。應用程式可能會在前 20 個字元之後顯示刪節號，以確保在較小的螢幕上可顯示完整字串。
`programLogo`	`object (Image)` 禮物卡方案或公司的標誌。這個標誌會顯示在應用程式的詳細資料和清單檢視畫面中。
`pinLabel`	`string` 用來表示 PIN 碼的標籤，例如「4 位數 PIN 碼」。
`eventNumberLabel`	`string` 用來表示活動編號的標籤，例如「目標活動編號」。
`allowBarcodeRedemption`	`boolean` 決定商家是否支援使用條碼兌換禮物卡。如果為 true，應用程式會在禮物卡詳細資料畫面上顯示禮物卡的條碼。如果值為 false，則不會顯示條碼。
`localizedMerchantName`	`object (LocalizedString)` businessName 的翻譯字串。應用程式可能會在前 20 個字元之後顯示刪節號，以確保在較小的螢幕上可顯示完整字串。
`localizedPinLabel`	`object (LocalizedString)` PinLabel 的翻譯字串。
`localizedEventNumberLabel`	`object (LocalizedString)` eventNumberLabel 的翻譯字串。
`cardNumberLabel`	`string` 用來表示卡片號碼的標籤，例如「卡號」。
`localizedCardNumberLabel`	`object (LocalizedString)` cardNumberLabel 的翻譯字串。
`classTemplateInfo`	`object (ClassTemplateInfo)` 類別顯示方式的範本資訊。如未設定，Google 會改回顯示一組預設欄位。
`id`	`string` 必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應依循 `issuer ID` 格式。`identifier` 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
`version (deprecated)`	`string (int64 format)` 這個項目已遭淘汰！已淘汰
`issuerName`	`string` 必要欄位。核發者名稱。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
`messages[]`	`object (Message)` 應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到相關訊息。這類欄位的數量上限是 10 個。
`allowMultipleUsersPerObject (deprecated)`	`boolean` 這個項目已遭淘汰！已淘汰，請改用 `multipleDevicesAndHoldersAllowedStatus`。
`homepageUri`	`object (Uri)` 應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (轉譯物件時，首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。
`locations[]`	`object (LatLongPoint)` 注意：這個欄位目前不支援觸發地理通知。
`reviewStatus`	`enum (ReviewStatus)` 必要欄位。類別的狀態。可以透過插入、修補或更新 API 呼叫，將這個欄位設為 `draft` 或 `underReview`。一旦審查狀態從 `draft` 變更為其他狀態，就無法再變回 `draft`。當類別處於開發階段時，這個欄位應保留為 `draft`。`draft` 類別無法用於建立任何物件。如果您確認類別可供使用，應將這個欄位設為 `underReview`。平台會自動將這個欄位設為 `approved`，這樣就能立即用於建立或遷移物件。更新已處於 `approved` 的類別時，請繼續將這個欄位設為 `underReview`。
`review`	`object (Review)` 當類別標示為 `approved` 或 `rejected` 時，平台所設定的審查留言。
`infoModuleData (deprecated)`	`object (InfoModuleData)` 這個項目已遭淘汰！已淘汰，請改用 textModulesData。
`imageModulesData[]`	`object (ImageModuleData)` 圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個，類別物件層級則為 1 個。
`textModulesData[]`	`object (TextModuleData)` 文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為物件的 10 個，以及來自類別的 10 個欄位。
`linksModuleData`	`object (LinksModuleData)` 連結模組資料。如果物件中也定義了連結模組資料，則兩項資料都會顯示。
`redemptionIssuers[]`	`string (int64 format)` 指出哪些兌換核發機構可透過智慧感應功能兌換票證。系統會透過核發機構 ID 來辨識兌換核發機構。兌換核發機構至少須設定一組智慧感應功能金鑰。 `enableSmartTap`和物件層級`smartTapRedemptionLevel`欄位也必須正確設定，票證才能支援智慧感應功能。
`countryCode`	`string` 國家/地區代碼，用於顯示卡片的國家/地區 (當使用者不在該國家/地區時)，以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。
`heroImage`	`object (Image)` 顯示在資訊卡正面的選用橫幅圖片。如果未提供，就不會顯示任何內容。圖片會以 100% 寬度顯示。
`wordMark (deprecated)`	`object (Image)` 這個項目已遭淘汰！已淘汰。
`enableSmartTap`	`boolean` 識別此類別是否支援智慧感應功能。`redemptionIssuers`和物件層級`smartTapRedemptionLevel`欄位也必須正確設定，票證才能支援智慧感應功能。
`hexBackgroundColor`	`string` 資訊卡的背景顏色。如未設定，則會使用主頁橫幅的主要顏色。如未設定主頁橫幅，則會使用標誌的主要顏色。格式為 #`rrggbb`，其中 `rrggbb` 是十六進位的 RGB 三元組，例如 `#ffcc00`。您也可以使用 RGB 三元組的簡寫版本 #`rgb`，例如 `#fc0`。
`localizedIssuerName`	`object (LocalizedString)` providerName 的翻譯字串。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
`multipleDevicesAndHoldersAllowedStatus`	`enum (MultipleDevicesAndHoldersAllowedStatus)` 表示是否有多位使用者和裝置會儲存參照這個類別的相同物件。
`callbackOptions`	`object (CallbackOptions)` 每當使用者儲存/刪除這個類別的物件時，可以使用這些回呼選項來呼叫發卡機構。這個類別的所有物件都適用回呼功能。
`securityAnimation`	`object (SecurityAnimation)` 安全動畫的選用資訊。如果設定此屬性，票證詳細資料上會顯示安全性動畫。
`viewUnlockRequirement`	`enum (ViewUnlockRequirement)` 查看禮物卡的解鎖規定選項。
`wideProgramLogo`	`object (Image)` 禮物卡方案或公司的寬版標誌。提供這項資訊後，該標誌會取代資訊卡檢視畫面左上方的方案標誌。
`appLinkData`	`object (AppLinkData)` 應用程式或網站連結 (選用) 會顯示為票證正面按鈕。如果為相對應的物件提供 AppLinkData，系統會改用該物件。

方法
`addmessage`	在指定類別 ID 參照的禮物卡類別中新增訊息。
`get`	傳回具有指定類別 ID 的禮物卡類別。
`insert`	插入具有指定 ID 和屬性的禮物卡類別。
`list`	傳回指定核發者 ID 的所有禮物卡類別清單。
`patch`	更新指定類別 ID 參照的禮物卡類別。
`update`	更新指定類別 ID 參照的禮物卡類別。

REST Resource: giftcardclass

資源：GiftCardClass

方法

`addmessage`

`get`

`insert`

`list`

`patch`

`update`