برای انجام بهروزرسانیهای بلادرنگ ، باید درخواستهایی را به API رزرو نقشهها ارسال کنید. API رزرو نقشهها مستلزم آن است که درخواستهای خود را از طریق OAuth 2.0 با استفاده از یک حساب سرویس GCP که به API دسترسی دارد و QPS لازم به آن اختصاص داده شده است، تأیید کنید. این راهنما شما را در مراحل زیر راهنمایی میکند:
- پروژه گوگل کلود خود را راهاندازی کنید
- ایجاد حساب کاربری سرویس
- API رزرو نقشهها را در پروژه GCP خود فعال کنید
- اشکالزدایی مشکلات رایج
برای اطلاعات بیشتر در مورد نحوه ارسال درخواست به API، به بخش بهروزرسانیهای API در لحظه در راهنمای پیشنهادات رزرو مراجعه کنید.
راهاندازی پروژه گوگل کلود خود با مرکز عملیات
- وارد حساب کاربری پلتفرم ابری گوگل خود شوید.
- برای این منظور میتوانید یک پروژه جدید ایجاد کنید یا از یک پروژه موجود استفاده کنید.
- لطفاً شماره پروژه ابری را یادداشت کنید زیرا در مراحل بعدی به آن نیاز خواهید داشت. شماره پروژه ابری شما را میتوانید در صفحه اصلی پلتفرم ابری گوگل نیز پیدا کنید. شماره پروژه ابری همیشه فقط عددی است.
- لطفاً شماره پروژه ابری را یادداشت کنید زیرا در مراحل بعدی به آن نیاز خواهید داشت. شماره پروژه ابری شما را میتوانید در صفحه اصلی پلتفرم ابری گوگل نیز پیدا کنید. شماره پروژه ابری همیشه فقط عددی است.
- وارد پورتال شرکا شوید.
- مرحله ۱ را در صفحه وظایف پذیرش (Onboarding Tasks) در پورتال شرکا با ارسال شماره پروژه ابری و آدرس ایمیل پروژه ابری (ایمیلی که برای مدیریت پروژه ابری استفاده میشود) تکمیل کنید.
ایجاد یک حساب کاربری سرویس و اعتبارنامههای OAuth
- دوباره وارد حساب کاربری پلتفرم ابری گوگل خود شوید.
- به بخش مدیریت و دسترسی > حسابهای سرویس بروید.
- شناسه پروژه ابری موجود یا تازه ایجاد شده خود را جستجو کنید.
- یک حساب کاربری خدماتی ایجاد کنید .
- جزئیات حساب سرویس را پر کنید.
- به حساب سرویس جدید، نقشی را اختصاص دهید که برای نیازهای برنامه شما مناسبترین باشد. انتخاب نقش برای حساب سرویس هیچ تاثیری بر فراخوانیهای قابل انجام به API رزرو نقشههای گوگل نخواهد داشت، زیرا تخصیص سهمیه کافی برای استفاده از آنها به جای آن توسط شماره پروژه شما در پیکربندی مرکز عملیات تعیین میشود. اگر مطمئن نیستید چه نقشی را انتخاب کنید، کافیست Project > Viewer را انتخاب کنید.
- پس از کلیک روی «ادامه» در مرحله (6)، به شما گزینهای برای ایجاد کلیدهای JSON داده میشود.
- اعتبارنامههای json را ذخیره کنید. حتماً این موارد را در مکانی امن ذخیره کنید، زیرا بعداً نمیتوانید آنها را بازیابی کنید.
- دوباره وارد پورتال شرکا شوید و وظایف باقیمانده را در صفحه وظایف استخدامی پورتال شرکا انجام دهید.
فعال کردن API MapsBooking
- وارد حساب کاربری پلتفرم ابری گوگل خود شوید.
- به API و خدمات > داشبورد بروید.
- روی فعال کردن APIها و خدمات کلیک کنید و
Google Maps Booking APIرا جستجو کنید.
- API های زیر را فعال کنید:
- API رزرو نقشه گوگل
- API رزرو نقشه گوگل (توسعهیافته)
خطاهای رایج
دلایل مختلفی وجود دارد که ممکن است هنگام ارسال درخواستهای بهروزرسانی بلادرنگ با مشکلات مجوز مواجه شوید. اگر به راهنمایی کلی در مورد نحوه ارسال درخواستهای بهروزرسانی بلادرنگ نیاز دارید، به بخش بهروزرسانیهای API بلادرنگ ما در راهنمای پیشنهادات رزرو مراجعه کنید. همچنین میتوانید نمونههای کلاینت را به زبانهای مختلف در بخش نمونههای کد پیدا کنید.
اگر با خطای ۴۰۳ مواجه شدید، بررسی کنید که آیا تمام الزامات زیر را رعایت میکنید یا خیر:
- از کتابخانه کلاینت گوگل استفاده کنید.
- با استفاده از Service Account Auth، اعتبارنامههای OAuth ایجاد کنید.
- در محدوده مناسب مجوز دهید.
- با نقطه پایانی مناسب (که در زیر ذکر شده است) تماس برقرار کنید.
مطمئن شوید که با نقطه پایانی صحیح تماس برقرار میکنید:
- سندباکس:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - تولید:
https://mapsbooking.googleapis.com/v1alpha/...
مطمئن شوید که درخواستهای اعتبارنامه OAuth خود را به درستی تأیید میکنید:
- شما در حال تأیید دامنهی «https://www.googleapis.com/auth/mapsbooking» هستید.
- شما از کلید حساب سرویس ایجاد شده در بخش «ایجاد حساب سرویس» و اعتبارنامههای OAuth استفاده میکنید.
هنوز خطا میبینید؟
اگر پس از انجام این مراحل هنوز خطاها را مشاهده میکنید، با اطلاعات زیر با مرکز عملیات خود تماس بگیرید:
- شماره پروژه ابری و شناسه پروژه به همراه اسکرین شات
- شناسه حساب سرویس
- ایمیلی که برای ایجاد حساب کاربری سرویس استفاده شده است
- جزئیات نقطه پایانی تلاش کردند درخواستهایی را برای
- زمان تلاش برای درخواست
- درخواست کامل و پیامهای خطای دریافتی هنگام ارسال درخواستها.