مجوزهای پیوندشده خودکار

پس‌زمینه

ویژگی «مجوزهای پیوندشده خودکار» به شما امکان می‌دهد مجوزهای اضافی را به کاربری که ازقبل مجوز موجود شما را در «کیف پول Google» خود دارد ارسال کنید. همچنین می‌توانید وقتی کاربر کارت اصلی (کارت اصلی) را ذخیره می‌کند، کارت‌ها را ازقبل به کارت اصلی پیوند دهید. «کارت پیوندشده خودکار» با کارت اصلی گروه‌بندی می‌شود و با یک آوانما در بالای کارت اصلی به کاربر اطلاع داده می‌شود که کارت جدیدی پیوند شده است. انواع مجوزهای زیر به‌عنوان مجوزهای اصلی یا پیوندشده پشتیبانی می‌شوند:

• بلیت رویداد
• کارت پرواز
• کارت بلیت
• پیشنهاد ویژه
• کارت هدیه
• مجوز وفاداری
• مجوز عمومی

مجوز اصلی با توضیحی که نشان می‌دهد مجوز جدیدی اضافه شده است	کارت جدید به کارت اصلی پیوند شد

موارد استفاده

ممکن است موارد استفاده مختلفی برای پیوند دادن مجوزها به مجوز موجود داشته باشید. چند نمونه عبارت‌اند از:

• پیشنهادی را به کارت وفاداری موجود پیوند دهید.
• پیوند دادن گشت‌برگ غذا به کارت پرواز یا بلیت رویداد.
• پیوند دادن مجوز پارکینگ به بلیت رویداد.

برخی ملاحظات هنگام استفاده از «مجوزهای پیوندشده خودکار»

• شیء اصلی و شیء پیوندشده باید از issuerId یکسانی استفاده کنند.
• برای هر شیء اصلی، حد مجاز ۵۰ شیء پیوندشده وجود دارد.
• ارسال خودکار مجوزهای پیوندشده تضمین نمی‌شود و به‌عنوان بهترین تلاش درنظر گرفته می‌شود. کاربران می‌توانند از دریافت «مجوزهای پیوندشده خودکار» انصراف دهند. اگر مورد استفاده بحرانی است و کاربر باید مجوز پیوندشده را دریافت کند، توصیه می‌کنیم ازطریق کانال دیگری ارتباط برقرار کنید تا مطمئن شوید کاربر مجوز را اضافه می‌کند.
• به‌روزرسانی‌های خط‌مشی استفاده قابل‌قبول «کیف پول Google» شامل راهنمایی درباره استفاده از «مجوزهای پیوندشده خودکار» است که باید رعایت شود.

مراحل یکپارچه‌سازی

اگر قبلاً شیء اصلی ایجاد کرده‌اید، می‌توانید از مرحله ۱ رد شوید.

1. شیء از هر نوع مجوز فهرست‌شده با پارامترهای لازم ایجاد کنید. این شیء اصلی است.
2. شیء دیگری از هر نوع مجوز فهرست‌شده ایجاد کنید. این شیء پیوندشده خواهد بود.
3. قبل یا بعداز ذخیره شدن شیء اصلی، شیء اصلی را با شناسه شیء پیوندشده در پارامتر linkedObjectIds به‌روز کنید.

برای تنظیم linkedObjectIds در کارت اصلی، حداقل بار داده لازم است. ۳ پارامتر الزامی عبارتند از:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

نمونه درخواست JSON برای افزودن شیء پیوندشده به شیء مجوز

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

نمونه پاسخ JSON پس‌از پیوند دادن شیء به شیء مجوز

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

رفتار موردانتظار

پس‌از دریافت پاسخ موفقیت‌آمیز، دستگاه‌های دارای مجوزی که به‌روزرسانی کردید باید مجوز پیوندشده را دریافت کنند. این مجوز پیوندشده با مجوز اصلی گروه‌بندی خواهد شد. کاربران می‌توانند با تند کشیدن به راست، مجوز پیوندشده را ببینند.

رسیدگی به استثنا

ممکن است خطاهای احتمالی درصورت استفاده نادرست از API رخ دهد که می‌تواند شامل موارد زیر باشد؛

ارسال پیام	دلیل
شیء اصلی و شیء پیوندشده شناسه صادرکننده یکسانی ندارند.	نمی‌توانید شیء پیوندشده را به شیء صادرکننده دیگری پیوست کنید.
شیء اصلی و شیء پیوندشده به یک شیء اشاره می‌کنند.	نمی‌توانید همان شیء را به‌عنوان linkedObject پیوست کنید.
شیء پیوندشده وجود ندارد.	شیء پیوندشده باید ازقبل در Wallet API درج شده باشد.
شیء پیوندشده ازقبل شیء پیوندشده دیگری دارد. اشیاء پیوندشده تودرتو اضافه نمی‌شود.	اشیاء پیوندشده نمی‌توانند شیء پیوندشده دیگری داشته باشند.
شیء قبلاً به شیء دیگری پیوند داده شده است. نمی‌توان اشیای پیوندشده تودرتو اضافه کرد.	شیء اصلی نمی‌تواند به‌تنهایی شیء پیوندشده باشد.
نمی‌توانید شیء پیوندشده دیگری اضافه کنید، از حد مجاز فراتر رفته‌اید.	به حد مجاز ۵۰ مجوز پیوندشده برای مجوز اصلی رسیده‌اید.