PassConstraints
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
ScreenshotEligibility
列舉 |
SCREENSHOT_ELIGIBILITY_UNSPECIFIED |
預設值,與 ELIGIBLE 相同。 |
ELIGIBLE |
如未設定螢幕截圖資格,則所有現有票證的預設行為。允許在 Android 裝置上擷取螢幕畫面。 |
INELIGIBLE |
禁止在 Android 裝置上擷取螢幕截圖。請注意,舊版錢包可能仍允許擷取螢幕截圖。 |
NfcConstraint
列舉 |
NFC_CONSTRAINT_UNSPECIFIED |
預設值,未指定任何限制。 |
BLOCK_PAYMENT |
票證開啟時,系統不會顯示付款卡。 |
BLOCK_CLOSED_LOOP_TRANSIT |
系統不會在票證開啟時傳輸封閉式迴路的大眾運輸票證。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003ePass constraints can be set to control screenshot eligibility and NFC behavior.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003escreenshotEligibility\u003c/code\u003e determines if screenshots of the pass are allowed on Android devices, with options for eligible or ineligible.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003enfcConstraint\u003c/code\u003e allows restrictions on NFC interactions when the pass is open, such as blocking payments or closed-loop transit cards.\u003c/p\u003e\n"],["\u003cp\u003eThe default behavior for screenshots is eligible, and there are no NFC constraints by default.\u003c/p\u003e\n"]]],["Pass constraints are defined through `screenshotEligibility` and `nfcConstraint`. `screenshotEligibility` controls screenshot capture with `ELIGIBLE` (default) or `INELIGIBLE` options. `nfcConstraint` manages NFC interactions, allowing `BLOCK_PAYMENT` to prevent payment card conveyance and `BLOCK_CLOSED_LOOP_TRANSIT` to block closed-loop transit card conveyance. Unspecified settings use default behaviors: `SCREENSHOT_ELIGIBILITY_UNSPECIFIED` defaults to `ELIGIBLE` and `NFC_CONSTRAINT_UNSPECIFIED` implies no constraints.\n"],null,["# PassConstraints\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ScreenshotEligibility](#ScreenshotEligibility)\n- [NfcConstraint](#NfcConstraint)\n\nContainer for any constraints that may be placed on passes.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"screenshotEligibility\": enum (/wallet/reference/rest/v1/PassConstraints#ScreenshotEligibility), \"nfcConstraint\": [ enum (/wallet/reference/rest/v1/PassConstraints#NfcConstraint) ] } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `screenshotEligibility` | `enum (`[ScreenshotEligibility](/wallet/reference/rest/v1/PassConstraints#ScreenshotEligibility)`)` The screenshot eligibility for the pass. |\n| `nfcConstraint[]` | `enum (`[NfcConstraint](/wallet/reference/rest/v1/PassConstraints#NfcConstraint)`)` The NFC constraints for the pass. |\n\nScreenshotEligibility\n---------------------\n\nDefines if/how screenshots may be taken of a pass.\n\n| Enums ||\n|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `SCREENSHOT_ELIGIBILITY_UNSPECIFIED` | Default value, same as ELIGIBLE. |\n| `ELIGIBLE` | Default behavior for all existing Passes if ScreenshotEligibility is not set. Allows screenshots to be taken on Android devices. |\n| `INELIGIBLE` | Disallows screenshots to be taken on Android devices. Note that older versions of Wallet may still allow screenshots to be taken. |\n\nNfcConstraint\n-------------\n\nDefines possible NFC constraints for the pass.\n\n| Enums ||\n|------------------------------|------------------------------------------------------------------------|\n| `NFC_CONSTRAINT_UNSPECIFIED` | Default value, no specified constraint. |\n| `BLOCK_PAYMENT` | Payment cards will not be conveyed while the pass is open. |\n| `BLOCK_CLOSED_LOOP_TRANSIT` | Closed loop transit cards will not be conveyed while the pass is open. |"]]