新增一般票證的連結

新增一般票證連結的方式有四種。

  • 使用 GenericClass.LinksModuleData，將連結加到與 GenericClass 相關聯的所有一般票證。
  • 使用 GenericObject.LinksModuleData 將連結新增至特定通用憑證 GenericObject。
  • 使用 GenericObject.appLinkData 將應用程式連結做為特定票證底部區段的第一個項目。
  • 使用 GenericClass.appLinkData，將應用程式連結放在該類別所有票證底部區段的第一個項目。

應用程式連結的一項優點是，可讓行動號召將使用者從 Google 錢包帶往品牌體驗。使用這項功能時，連結會顯示在票證底部區段的第一個項目。

功能範例

核發機構名稱應用程式連結資料範例
監理機關

請針對特定通用票證設定 GenericObject.appLinkData 欄位，以設定應用程式或網站的 URI 或套件名稱。

請參閱下方原始碼 appLinkData 欄位的格式和結構定義： displayText 欄位最多只能有 30 個字元。 

  {
    "id": string,
    "classId": string,
    …
    …
    …
    "appLinkData": {
      "androidAppLinkInfo": {
        "appTarget": {
          "packageName": "com.google.android.gm",
        }
      },
      "webAppLinkInfo": {
        "appTarget": {
           "targetUri": {
              "uri": "https://mail.google.com/mail/",
              "description": "Web link for Gmail"
           }
        }
      },
      "displayText": {
        "defaultValue": {
           "value": "Our awesome app!"
        }
      }
    }
  }
為求長久，以下實作方式也適用。 
{
  "id": string,
  "classId": string,
  …
  …
  …
  "appLinkData": {
    "androidAppLinkInfo": {
      "appTarget": {
        "targetUri": {
          "uri": "https://play.google.com/store/apps/details?id=com.google.android.gm",
            "description": "Play store link for Gmail app"
        }
      }
    }
  }
}