Method: jwt.insert
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://walletobjects.googleapis.com/walletobjects/v1/jwt
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體包含 JwtResource
的例項。
回應主體
JSON 表示法 |
{
"saveUri": string,
"resources": {
object (Resources )
}
} |
欄位 |
saveUri |
string
URI 開啟後,使用者就能將 JWT 中識別的物件儲存至 Google 帳戶。
|
resources |
object (Resources )
與 JWT 中提供的類別 ID 和物件 ID 相對應的資料。資源只會包含非空白陣列 (也就是說,如果 JWT 僅包含 eventTicketObjects,那麼資源中只會出現這個欄位)。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/wallet_object.issuer
資源
JSON 表示法 |
{
"eventTicketClasses": [
{
object (EventTicketClass )
}
],
"eventTicketObjects": [
{
object (EventTicketObject )
}
],
"flightClasses": [
{
object (FlightClass )
}
],
"flightObjects": [
{
object (FlightObject )
}
],
"giftCardClasses": [
{
object (GiftCardClass )
}
],
"giftCardObjects": [
{
object (GiftCardObject )
}
],
"loyaltyClasses": [
{
object (LoyaltyClass )
}
],
"loyaltyObjects": [
{
object (LoyaltyObject )
}
],
"offerClasses": [
{
object (OfferClass )
}
],
"offerObjects": [
{
object (OfferObject )
}
],
"transitClasses": [
{
object (TransitClass )
}
],
"transitObjects": [
{
object (TransitObject )
}
],
"genericClasses": [
{
object (GenericClass )
}
],
"genericObjects": [
{
object (GenericObject )
}
]
} |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eInserts resources into a JWT for Google Wallet.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to \u003ccode\u003ehttps://walletobjects.googleapis.com/walletobjects/v1/jwt\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/wallet_object.issuer\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body contains a \u003ccode\u003eJwtResource\u003c/code\u003e object, and the response includes a save URI and inserted resource data.\u003c/p\u003e\n"],["\u003cp\u003eResource data in the response includes arrays of objects and classes for various Google Wallet pass types, like event tickets, flights, or loyalty cards.\u003c/p\u003e\n"]]],["This documentation details the process of inserting resources into a JWT via a `POST` request to `https://walletobjects.googleapis.com/walletobjects/v1/jwt`. The request body contains a `JwtResource` instance. The successful response includes a `saveUri` string for users to save objects and a `resources` object. This object contains arrays of classes and objects, including event tickets, flights, gift cards, loyalty programs, offers, transit options, and generic types, based on what's in the JWT. It requires the `https://www.googleapis.com/auth/wallet_object.issuer` OAuth scope.\n"],null,["# Method: jwt.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.JwtInsertResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Resources](#Resources)\n - [JSON representation](#Resources.SCHEMA_REPRESENTATION)\n\nInserts the resources in the JWT.\n\n### HTTP request\n\n`POST https://walletobjects.googleapis.com/walletobjects/v1/jwt`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [JwtResource](/wallet/reference/rest/v1/jwt#JwtResource).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------|\n| ``` { \"saveUri\": string, \"resources\": { object (/wallet/reference/rest/v1/jwt/insert#Resources) } } ``` |\n\n| Fields ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `saveUri` | `string` A URI that, when opened, will allow the end user to save the object(s) identified in the JWT to their Google account. |\n| `resources` | `object (`[Resources](/wallet/reference/rest/v1/jwt/insert#Resources)`)` Data that corresponds to the ids of the provided classes and objects in the JWT. resources will only include the non-empty arrays (i.e. if the JWT only includes eventTicketObjects, then that is the only field that will be present in resources). |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`\n\nResources\n---------\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"eventTicketClasses\": [ { object (/wallet/reference/rest/v1/eventticketclass#EventTicketClass) } ], \"eventTicketObjects\": [ { object (/wallet/reference/rest/v1/eventticketobject#EventTicketObject) } ], \"flightClasses\": [ { object (/wallet/reference/rest/v1/flightclass#FlightClass) } ], \"flightObjects\": [ { object (/wallet/reference/rest/v1/flightobject#FlightObject) } ], \"giftCardClasses\": [ { object (/wallet/reference/rest/v1/giftcardclass#GiftCardClass) } ], \"giftCardObjects\": [ { object (/wallet/reference/rest/v1/giftcardobject#GiftCardObject) } ], \"loyaltyClasses\": [ { object (/wallet/reference/rest/v1/loyaltyclass#LoyaltyClass) } ], \"loyaltyObjects\": [ { object (/wallet/reference/rest/v1/loyaltyobject#LoyaltyObject) } ], \"offerClasses\": [ { object (/wallet/reference/rest/v1/offerclass#OfferClass) } ], \"offerObjects\": [ { object (/wallet/reference/rest/v1/offerobject#OfferObject) } ], \"transitClasses\": [ { object (/wallet/reference/rest/v1/transitclass#TransitClass) } ], \"transitObjects\": [ { object (/wallet/reference/rest/v1/transitobject#TransitObject) } ], \"genericClasses\": [ { object (/wallet/reference/rest/v1/genericclass#GenericClass) } ], \"genericObjects\": [ { object (/wallet/reference/rest/v1/genericobject#GenericObject) } ] } ``` |\n\n| Fields ||\n|------------------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `eventTicketClasses[]` | `object (`[EventTicketClass](/wallet/reference/rest/v1/eventticketclass#EventTicketClass)`)` A list of event ticket classes. |\n| `eventTicketObjects[]` | `object (`[EventTicketObject](/wallet/reference/rest/v1/eventticketobject#EventTicketObject)`)` A list of event ticket objects. |\n| `flightClasses[]` | `object (`[FlightClass](/wallet/reference/rest/v1/flightclass#FlightClass)`)` A list of flight classes. |\n| `flightObjects[]` | `object (`[FlightObject](/wallet/reference/rest/v1/flightobject#FlightObject)`)` A list of flight objects. |\n| `giftCardClasses[]` | `object (`[GiftCardClass](/wallet/reference/rest/v1/giftcardclass#GiftCardClass)`)` A list of gift card classes. |\n| `giftCardObjects[]` | `object (`[GiftCardObject](/wallet/reference/rest/v1/giftcardobject#GiftCardObject)`)` A list of gift card objects. |\n| `loyaltyClasses[]` | `object (`[LoyaltyClass](/wallet/reference/rest/v1/loyaltyclass#LoyaltyClass)`)` A list of loyalty classes. |\n| `loyaltyObjects[]` | `object (`[LoyaltyObject](/wallet/reference/rest/v1/loyaltyobject#LoyaltyObject)`)` A list of loyalty objects. |\n| `offerClasses[]` | `object (`[OfferClass](/wallet/reference/rest/v1/offerclass#OfferClass)`)` A list of offer classes. |\n| `offerObjects[]` | `object (`[OfferObject](/wallet/reference/rest/v1/offerobject#OfferObject)`)` A list of offer objects. |\n| `transitClasses[]` | `object (`[TransitClass](/wallet/reference/rest/v1/transitclass#TransitClass)`)` A list of transit classes. |\n| `transitObjects[]` | `object (`[TransitObject](/wallet/reference/rest/v1/transitobject#TransitObject)`)` A list of transit objects. |\n| `genericClasses[]` | `object (`[GenericClass](/wallet/reference/rest/v1/genericclass#GenericClass)`)` A list of generic classes. |\n| `genericObjects[]` | `object (`[GenericObject](/wallet/reference/rest/v1/genericobject#GenericObject)`)` A list of generic objects. |"]]