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