Method: jwt.insert
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/jwt
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của JwtResource
.
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"saveUri": string,
"resources": {
object (Resources )
}
} |
Trường |
saveUri |
string
Khi được mở, URI sẽ cho phép người dùng cuối lưu(các) đối tượng được xác định trong JWT vào Tài khoản Google của họ.
|
resources |
object (Resources )
Dữ liệu tương ứng với mã nhận dạng của các lớp và đối tượng được cung cấp trong JWT. tài nguyên sẽ chỉ bao gồm các mảng không trống (tức là nếu JWT chỉ bao gồm eventticketObjects, thì đó là trường duy nhất có trong tài nguyên).
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/wallet_object.issuer
Tài nguyên
Biểu diễn dưới dạng 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 )
}
]
} |
Trường |
eventTicketClasses[] |
object (EventTicketClass )
Danh sách các hạng vé xem sự kiện.
|
eventTicketObjects[] |
object (EventTicketObject )
Danh sách đối tượng vé xem sự kiện.
|
flightClasses[] |
object (FlightClass )
Danh sách các hạng chuyến bay.
|
flightObjects[] |
object (FlightObject )
Danh sách đối tượng bay.
|
giftCardClasses[] |
object (GiftCardClass )
Danh sách các lớp thẻ quà tặng.
|
giftCardObjects[] |
object (GiftCardObject )
Danh sách đối tượng thẻ quà tặng.
|
loyaltyClasses[] |
object (LoyaltyClass )
Danh sách các lớp khách hàng thân thiết.
|
loyaltyObjects[] |
object (LoyaltyObject )
Danh sách đối tượng khách hàng thân thiết.
|
offerClasses[] |
object (OfferClass )
Danh sách các lớp ưu đãi.
|
offerObjects[] |
object (OfferObject )
Danh sách đối tượng ưu đãi.
|
transitClasses[] |
object (TransitClass )
Danh sách các lớp phương tiện công cộng.
|
transitObjects[] |
object (TransitObject )
Danh sách đối tượng chuyển tiếp.
|
genericClasses[] |
object (GenericClass )
Danh sách các lớp chung.
|
genericObjects[] |
object (GenericObject )
Danh sách đối tượng chung.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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. |"]]