برای اطمینان از امنیت داده‌ها، اعمال کنترل دسترسی، و حفظ یکپارچگی سیستم، باید همه درخواست‌های Merchant API را اصالت‌سنجی کنید. این میانای برنامه‌سازی کاربردی از هویت اصالت‌سنجی‌شده برای تعیین کنش‌هایی که تماس‌گیرنده اجازه انجام آن‌ها را دارد استفاده می‌کند. برای مثال، برخی‌از فراخوانندگان ممکن است دسترسی فقط خواندنی به داده‌های محصول داشته باشند، درحالی‌که دیگران می‌توانند تنظیمات حساب را در Merchant Center تغییر دهند.
این سند بخشی از یک مجموعه چندبخشی درباره شروع به کار با Merchant API است. اگر قبلاً اصالت‌سنجی را با Merchant API راه‌اندازی کرده‌اید، می‌توانید به بخش بعدی بروید: ثبت‌نام به‌عنوان توسعه‌دهنده
مجاز کردن درخواست‌ها برای Merchant API
هر درخواستی که به Merchant API ارسال می‌شود باید حاوی یک کد مجوز باشد تا برنامه شما را برای Google شناسایی کند. برای راه‌اندازی اصالت‌سنجی و صدور مجوز، مورد استفاده‌ای را انتخاب کنید که به بهترین شکل نحوه برنامه‌ریزی شما برای کار با Merchant API را توصیف می‌کند:
آیا درحال ساختن برنامه‌ای هستید که کسب‌وکارهای دیگر از آن استفاده کنند؟
اگر بله، از مجوز OAuth 2.0 استفاده می‌کنید. در شرایط زیر، مجوزدهی OAuth 2.0 را انتخاب کنید:
- شما ارائه‌دهنده یا کارگزاری شخص ثالث هستید: شما درحال ساختن برنامه‌ای هستید، مانند پلاتفرم SaaS، که کسب‌وکارهای دیگر از آن برای مدیریت داده‌های Merchant Center خودشان استفاده خواهند کرد.
- باید حساب‌های خارجی زیادی را مدیریت کنید: می‌خواهید یک برنامه واحد در چندین حساب Merchant Center مستقل که متعلق به مشتریان مختلف است کار کند. مشتریان شما با ورود به سیستم «حساب‌های Google» خودشان و کلیک کردن روی «مجاز کردن» در صفحه رضایت، اجازه‌ها را اعطا می‌کنند.
آیا برای کسب‌وکار خودتان برنامه می‌سازید؟
اگر بله، از مجوز حساب سرویس برای دسترسی به Merchant API استفاده می‌کنید. در شرایط زیر، مجوز حساب سرویس را انتخاب کنید:
- درحال ساختن برنامه داخلی خودتان هستید: درحال توسعه ابزاری به‌طور خاص برای کسب‌وکار خودتان هستید تا داده‌های Merchant Center خودتان را مدیریت کنید ، یا می‌خواهید اطلاعات کاربری متعلق به خود برنامه باشد نه یک کاربر فردی خاص.
- به خودکارسازی بدون ورود به سیستم انسانی نیاز دارید: برنامه‌تان تکالیف پس‌زمینه مانند به‌روزرسانی‌های خودکار موجودی یا کارهای «cron» را اجرا می‌کند.
مجوز OAuth 2.0
اگر ارائه‌دهنده شخص ثالث یا کارگزاری هستید که چندین حساب مشتری را مدیریت می‌کنید، برنامه شما باید از OAuth 2.0 برای مجاز کردن درخواست‌ها استفاده کند. برای راه‌اندازی OAuth 2.0 برای Merchant API، این مراحل را دنبال کنید:
- اعتبارنامه‌های OAuth 2.0 را در میاناهای برنامه‌سازی کاربردی و سرویس‌ها در کنسول Google Cloud خود ایجاد کنید
- اعتبارنامه‌های کارخواه OAuth2 را در فایلی مانند زیر بارگیری کنید
client-secrets.json - افزودن حساب ایمیل به‌عنوان کاربر به Merchant Center: مطمئن شوید که «حساب Google» که برای صدور مجوز درخواست‌ها استفاده می‌کنید به‌عنوان کاربر در Merchant Center وجود داشته باشد. برای جزئیات بیشتر، نحوه افزودن یا برداشتن کاربر از Merchant Center را ببینید
- نقش
Adminرا به آن اختصاص دهید تا ثبت‌نام را انجام دهد. برای اطلاعات بیشتر درباره نقش‌ها، مدیریت افراد و سطوح دسترسی در Merchant Center را ببینید - راه‌اندازی اصالت‌سنجی با نمونه کدها: راهنمایی‌های بخش اسناد راه‌اندازی اصالت‌سنجی و پیکربندی نمونه را دنبال کنید.
برای اطلاعات بیشتر درباره مجوز OAuth 2.0، به مجاز کردن دسترسی برنامه طرف سوم به حساب Merchant Center و استفاده از OAuth 2.0 برای دسترسی به Google API مراجعه کنید.
مجوز حساب سرویس
از حساب سرویس برای مجاز کردن دسترسی Merchant API به حساب Merchant Center خودتان استفاده می‌کنید. برای راه‌اندازی مجوز حساب سرویس برای Merchant API، این مراحل را دنبال کنید:
- ایجاد اعتبارنامه‌های حساب سرویس در میاناهای برنامه‌سازی کاربردی و سرویس‌ها در کنسول Google Cloud
- بارگیری کلید خصوصی: کلید خصوصی را در قالب JSON برای حساب سرویس ایجاد و بارگیری کنید. نام فایل را به
service-account.jsonتغییر دهید - افزودن حساب سرویس به Merchant Center: نشانی ایمیل حساب سرویس یکتا را (مثلاً
sa@project.iam.gserviceaccount.com) کپی کنید و آن را به‌عنوان کاربر جدید در Merchant Center خودتان اضافه کنید. برای جزئیات بیشتر، نحوه افزودن یا برداشتن کاربر از Merchant Center را ببینید - دسترسی
Adminرا به آن اختصاص دهید. برای اطلاعات بیشتر درباره سطوح دسترسی، مدیریت افراد و سطوح دسترسی در Merchant Center را ببینید - راه‌اندازی اصالت‌سنجی با نمونه کدها: راهنمایی‌های بخش اسناد راه‌اندازی اصالت‌سنجی و پیکربندی نمونه را دنبال کنید.
برای اطلاعات بیشتر درباره مجوز حساب خدمات، به مجوز دادن به دسترسی به حساب Merchant Center و نمای کلی حساب‌های خدمات مراجعه کنید.