مجوزهای خودکار مرتبط

پس زمینه

ویژگی Auto Linked Passes به شما امکان می دهد مجوزهای اضافی را برای کاربری ارسال کنید که قبلاً مجوز فعلی شما را در Google Wallet خود دارد. همچنین می‌توانید زمانی که کاربر پاس اصلی (اصلی) را ذخیره می‌کند، گذرنامه‌ها را به یک پاس اصلی پیوند دهید. گذرنامه پیوند شده خودکار با مجوز اصلی با یک فراخوان بالای مجوز اصلی گروه بندی می شود که به کاربر اطلاع می دهد که یک مجوز جدید پیوند داده شده است. انواع پاس زیر به عنوان پاس های اولیه یا پیوندی پشتیبانی می شوند.

  • بلیط رویداد
  • کارت پرواز
  • پاس ترانزیت
  • پیشنهاد
  • کارت هدیه
  • پاس وفاداری
  • پاس عمومی
مثال اصلی پاس با پیوند خودکارمثال ثانویه پاس مرتبط خودکار
مجوز اولیه با فراخوانی که یک پاس جدید اضافه شده است مجوز جدید متصل به مجوز اصلی

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

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

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

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

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

مراحل ادغام

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

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

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

  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 درج شده باشد.
شی پیوند داده شده قبلاً دارای یک شی پیوند خورده دیگر است. نمی توان اشیاء پیوند تودرتو اضافه کرد. اشیاء پیوندی نمی توانند شیء پیوندی دیگری داشته باشند.
شی قبلاً به شی دیگری پیوند داده شده است. نمی توان اشیاء پیوند تودرتو اضافه کرد. شی اولیه نمی تواند به خودی خود یک شیء پیوندی باشد.
نمی توان هیچ شیء پیوندی دیگری اضافه کرد، از حد مجاز فراتر رفت. حداکثر 50 پاس پیوندی برای پاس اولیه رسیده است.