Method: walletobjects.v1.privateContent.setPassUpdateNotice

تقديم معلومات إلى Google حول انتظار تحديث البطاقة الخاصة سيسمح ذلك لشركة Google بتقديم إشعار التحديث إلى الجهاز الذي يتضمّن حاليًا هذه البطاقة.

طلب HTTP

POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "externalPassId": string,
  "updatedPassJwtSignature": string,
  "updateUri": string
}
الحقول
externalPassId

string

مطلوب. معرّف مؤهَّل بالكامل للبطاقة التي يريد مُصدِرها إرسال إشعار بها إلى حاملي البطاقة يتم تنسيقه على النحو التالي: <issuerId.externalUid>.
updatedPassJwtSignature

string

مطلوب. توقيع JWT للبطاقة المعدَّلة التي يريد مُصدِرها إبلاغ Google بها ولن تتلقّى الإشعار إلا الأجهزة التي تُبلغ عن توقيع JWT مختلف عن توقيع JWT هذا.
updateUri

string

مطلوب. معرّف الموارد المنتظم (URI) لنقطة نهاية جهة الإصدار الذي يجب أن يتّبعه حامل البطاقة لتلقّي رمز JWT معدَّل للبطاقة ولا يمكن أن يحتوي على أي معلومات حسّاسة. يجب أن تتم مصادقة المستخدم من خلال نقطة النهاية قبل منحه رمز JWT المعدَّل. مثال على معرّف الموارد المنتظم (URI) لتعديل البطاقة https://someissuer.com/update/passId=someExternalPassId

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/wallet_object.issuer