این راهنما توضیح می‌دهد که چگونه از OAuth 2.0 برای درخواست دسترسی به حساب‌های Merchant Center طرف‌های دیگر استفاده کنید. اگر ارائه‌دهنده طرف سوم هستید، از این گردش کار استفاده کنید تا برنامه‌تان بتواند برای دسترسی به حساب‌های Merchant Center مشتریانتان درخواست دهد.
اگر درحال توسعه برنامه داخلی هستید که فقط به حساب Merchant Center شما نیاز دارد، به‌جای آن دسترسی به حساب را ببینید.
درخواست درستی‌سنجی برنامه
برنامه‌هایی که به Merchant API دسترسی دارند باید فرایند بازبینی درستی‌سنجی OAuth را طی کنند. برنامه‌های تأییدنشده هشدار دریافت می‌کنند و عملکرد محدودی خواهند داشت.
برنامه هر چیزی است که شناسه کارخواه OAuth 2.0 یکتا در Google Cloud داشته باشد.
فرایند درستی‌سنجی معمولاً ۳ تا ۵ روز کاری طول می‌کشد. برای کسب اطلاعات بیشتر و ارسال درخواست درستی‌سنجی، درستی‌سنجی برای برنامه‌ها را ببینید.
این خط‌مشی برای همه برنامه‌ها اعمال می‌شود. توصیه می‌کنیم همه برنامه‌ها در اسرع وقت فرایند درستی‌سنجی را طی کنند تا از بروز وقفه در کسب‌وکار جلوگیری شود.
دریافت دامنه‌های OAuth
برای جلوگیری از بروز مشکل در انتخاب گستره، مجوز افزایشی را راه‌اندازی کنید.
اگر بیش‌از یک محدوده OAuth درخواست کنید، همه آن‌ها به‌طور پیش‌فرض در صفحه کسب رضایت برای برنامه‌تان لغو انتخاب می‌شوند. وقتی برنامه‌تان صفحه رضایت را به کاربر نشان می‌دهد، کاربر باید هر گستره را به‌صورت دستی انتخاب کند تا دسترسی را مجاز کند.
برای استفاده از Merchant API، برنامه‌تان باید دامنه زیر را در صفحه رضایت OAuth درخواست کند:
https://www.googleapis.com/auth/content
پاسخ درخواست OAuth را بررسی کنید تا مطمئن شوید برنامه‌تان این دامنه را دریافت کرده است.
برای جزئیات بیشتر، خط‌مشی‌های OAuth 2.0 را ببینید.
صدور مجوز درخواست‌ها
هر درخواستی که برنامه شما به Merchant API ارسال می‌کند باید شامل یک کد مجوز باشد. این کد همچنین برنامه شما را برای Google شناسایی می‌کند.
درباره پروتکل‌های صدور مجوز
برنامه شما باید از OAuth 2.0 برای صدور مجوز درخواست‌ها استفاده کند. از هیچ پروتکل مجوز دیگری پشتیبانی نمی‌شود. اگر برنامه‌تان از ورود به سیستم با Google استفاده می‌کند، برخی‌از جنبه‌های صدور مجوز برای شما مدیریت می‌شود.
مجاز کردن درخواست‌ها با OAuth 2.0
همه درخواست‌ها به Merchant API باید توسط کاربر اصالت‌سنجی‌شده مجاز شود.
جزئیات فرایند مجوز، یا «جریان»، برای OAuth 2.0 تا حدودی بسته به نوع برنامه‌ای که می‌نویسید متفاوت است. فرایند کلی زیر برای همه انواع درخواست‌ها اعمال می‌شود:
- وقتی برنامه‌تان را ایجاد می‌کنید، آن را بااستفاده از Google API Console ثبت می‌کنید. سپس Google اطلاعاتی را که بعداً نیاز خواهید داشت، مانند شناسه کارخواه و رمز کارخواه، ارائه می‌دهد.
- Merchant API را در «کنسول Google API» فعال کنید. (اگر API در «کنسول API» فهرست نشده است، این مرحله را رد کنید.)
- وقتی برنامه‌تان به دسترسی به داده‌های کاربر نیاز دارد، از Google درخواست محدوده دسترسی خاصی می‌کند.
- Google صفحه رضایت را به کاربر نشان می‌دهد و از او می‌خواهد به برنامه شما اجازه دهد برخی‌از داده‌هایش را درخواست کند.
- اگر کاربر تأیید کند، Google کد دسترسی کوتاه‌مدتی به برنامه شما می‌دهد.
- برنامه شما داده‌های کاربر را درخواست می‌کند و کد دسترسی را به درخواست پیوست می‌کند.
- اگر Google تشخیص دهد که درخواست و کد شما معتبر است، داده‌های درخواستی را برمی‌گرداند.
برخی‌از جریان‌ها شامل مراحل اضافی هستند، مانند استفاده از ژتون‌های بازآوری برای دریافت کد دسترسی جدید. برای اطلاعات دقیق درباره جریان‌های انواع مختلف برنامه‌ها، به اسناد OAuth 2.0 Google مراجعه کنید.
اطلاعات گستره OAuth 2.0 برای Merchant API در اینجا آمده است:
| حوزه | معنی |
|---|---|
https://www.googleapis.com/auth/content |
دسترسی خواندن/ نوشتن. |
برای درخواست دسترسی بااستفاده از OAuth 2.0، برنامه شما به اطلاعات دامنه و همچنین اطلاعاتی که Google هنگام ثبت برنامه ارائه می‌دهد (مانند شناسه کارخواه و رمز کارخواه) نیاز دارد.
در اینجا نمونه‌ای آورده شده است که می‌توانید برای مجوز استفاده کنید.