برای استفاده مؤثر از Merchant API، مهم است که مفاهیم ثبت‌نام، اصالت‌سنجی، و مجوزدهی را درک کنید. این دو نقش اهداف متمایزی را در تضمین دسترسی ایمن و صحیح به داده‌های Merchant Center دنبال می‌کنند.
اصطلاحات
ثبت‌نام، اصالت‌سنجی، و صدور مجوز با هم مرتبط هستند، اما هرکدام معنی و هدف متمایزی دارند.
- اصالت‌سنجی: در این فرایند، سرویس هویت کاربر یا برنامه‌ای را که درخواست میانای برنامه‌سازی کاربردی می‌دهد تأیید می‌کند. Merchant API از سازوکارهای استاندارد Google مانند OAuth 2.0 استفاده می‌کند. استفاده از کلیدهای میانای برنامه‌سازی کاربردی برای اصالت‌سنجی پشتیبانی نمی‌شود و منجر به خطاهای اصالت‌سنجی می‌شود. برای اطلاعات بیشتر، اصالت‌سنجی درخواست‌ها و اصالت‌سنجی به‌عنوان حساب خودتان را ببینید.
- مجوزدهی: این فرایند تعیین می‌کند که کاربر یا برنامه اصالت‌سنجی‌شده مجاز به انجام چه کنش‌هایی بااستفاده از حساب Merchant Center است. این روش به این سؤال پاسخ می‌دهد: «چه کاری می‌توانید انجام دهید؟» براساس نقش‌ها و اجازه‌های اعطاشده به کاربر اصالت‌سنجی‌شده در حساب Merchant Center. برای مثال، ممکن است کاربر برای خواندن داده‌های محصول مجاز باشد، اما برای تغییر تنظیمات حساب مجاز نباشد.
- ثبت‌نام: درخصوص Merchant API، این فرایند راه‌اندازی یک‌باره‌ای است که به Google امکان می‌دهد اعلامیه‌های خدمات مهم را برای حساب‌های فروشنده‌ای که مدیریت می‌کنید برایتان ارسال کند. ثبت‌نام، نشانی‌های ایمیل توسعه‌دهنده شما را به حساب Merchant Center اصلی‌تان اضافه می‌کند و آن را به شناسه(های) پروژه Google Cloud که برای اصالت‌سنجی استفاده می‌کنید پیوند می‌دهد. این پیوند به برنامه شما امکان می‌دهد برای همه حساب‌های فروشنده‌ای که مدیریت می‌کنید، اعلامیه‌های خدمات دریافت کند. برای اطلاعات بیشتر، ایجاد پروژه Google Cloud را ببینید.
ثبت‌نام
فرایند ثبت‌نام برای فعال کردن برنامه شما جهت استفاده از Merchant API بسیار مهم است. آنچه باید بدانید:
پیش‌نیازها
ثبت‌نام برای استفاده از Merchant API به موارد زیر نیاز دارد:
- حساب Merchant Center: باید حساب Merchant Center داشته باشید.
- دسترسی سرپرست: حساب کاربری Google که برای شروع تماس ثبت‌نام استفاده می‌کنید باید در حساب Merchant Center که ثبت می‌کنید، امتیازهای «سرپرست» داشته باشد.
- پروژه Google Cloud: برنامه شما باید با یک پروژه Google Cloud مرتبط باشد. این پروژه اعتبارنامه‌های لازم (مانند شناسه‌های کارخواه OAuth 2.0) را برای اصالت‌سنجی برنامه شما ارائه می‌دهد.
چرا نمی‌توانید پروژه Google Cloud مشترک را ثبت کنید
ابزارهایی مانند Google OAuth Playground و APIs Explorer از پروژه‌های Google Cloud مشترک و متعلق به Google استفاده می‌کنند. نمی‌توانید با پروژه‌های مشترک ثبت‌نام کنید چون:
- این گواهی‌ها برای آزمایش و کاوش درنظر گرفته شده‌اند، نه برای هویت برنامه تولید.
- ثبت آن‌ها به‌معنای پیوند بین ابزار هم‌رسانی‌شده و داده‌های Merchant Center خاص شما است و ممکن است منجر به ارتباطات ناخواسته شود.
برنامه شما به پروژه Google Cloud اختصاصی خودش نیاز دارد تا ارتباطات Merchant API که Google برای شما ارسال می‌کند با استفاده واقعی شما مرتبط باقی بماند.
بااین‌حال، می‌توانید از برنامه‌های وب OAuth Playground و API Explorer برای استفاده از Merchant API برای آزمایش و موارد استفاده غیرتولیدی استفاده کنید.
یافتن شناسه پروژه Google Cloud
می‌توانید شناسه پروژه و شماره پروژه خود را در «کنسول Google Cloud» پیدا کنید. برای جزئیات، به پیدا کردن نام، شماره، و شناسه پروژه مراجعه کنید.
برقراری تماس ثبت‌نام
بااستفاده از روش
registerGcp
در زیرمیانای برنامه‌سازی کاربردی Accounts ثبت‌نام کنید. این تماس «شماره پروژه» Google Cloud شما را با حساب Merchant Center مرتبط می‌کند.
درطول فرایند، باید نشانی ایمیلی را ارائه دهید که با کاربر خاصی که از آن برای فراخوانی API استفاده می‌کنید مرتبط باشد. این ایمیل باید متعلق به کاربری باشد که به حساب Merchant Center دسترسی سرپرست دارد.
درباره فیلد ایمیل
ارتباط مؤثر کلید اصلی است. Google به‌روزرسانی‌های مهم، «اعلامیه‌های اجباری خدمات» (MSA)، نظرسنجی‌های توسعه‌دهنده، و فرصت‌های دیگر مربوط به Merchant API را ارسال می‌کند. مدیریت صحیح مخاطبین تضمین می‌کند که این موارد به افراد مناسب برسد.
- هدف: Google از این نشانی ایمیل به‌عنوان مخاطب اصلی برای ارتباطات مربوط به API استفاده می‌کند.
- ایمیل چه کسی: این باید نشانی ایمیل توسعه‌دهنده فردی یا مخاطب فنی اصلی باشد که مسئول ادغام میانای برنامه‌سازی کاربردی است.
- روال‌های مطلوب:
- باید: از نشانی ایمیل شرکتی فرد استفاده کنید.
- نباید: از نام‌های مستعار گروهی عمومی یا ایمیل‌های حساب سرویس استفاده کنید. هدف ما از ارتباطات، گیرندگان انسانی است.
منبع users برای مدیریت مخاطب
درحالی‌که نشانی ایمیل در فراخوانی ثبت، مخاطب اولیه را تنظیم می‌کند،
روش قوی‌تر برای مدیریت مخاطبین و اجازه‌ها استفاده از منبع Merchant API
accounts.users
یا تنظیمات مدیریت کاربر در میانای کاربر Merchant Center است. برای اطلاعات بیشتر درباره استفاده از Merchant Center،
مدیریت افراد در حساب را ببینید.
از این ویژگی‌ها به‌صورت زیر بهره ببرید:
- افزودن همه توسعه‌دهندگان: توسعه‌دهندگانی را که روی یکپارچه‌سازی میانای برنامه‌سازی کاربردی کار می‌کنند به‌عنوان کاربران حساب Merchant Center اضافه کنید.
- واگذار کردن نقش
API_DEVELOPER: علاوه‌بر نقش‌های استاندارد (سرپرست، استاندارد)، می‌توانید نقشAPI_DEVELOPERرا به کاربران واگذار کنید. به‌ویژه، این نقش را به کاربرانی اختصاص دهید که باید ارتباطات مربوط به API را دریافت کنند. می‌توانید آن را با نقش‌های دیگر ترکیب کنید. - مزایا:
- جداسازی واضح: مدیریت مخاطب میانای برنامه‌سازی کاربردی را از ثبت‌نام یک‌باره جدا می‌کند.
- انعطاف‌پذیری: با تغییر اعضای تیم، مخاطبین را به‌روز کنید.
- ارتباطات هدفمند: تضمین می‌کند که اخبار مربوط به میانای برنامه‌سازی کاربردی به افراد مربوطه ارسال شود.
حتی اگر درطول ثبت‌نام نشانی ایمیل ارائه کرده‌اید، اکیداً توصیه می‌کنیم
مخاطبین API را با افزودن کاربران دارای نقش API_DEVELOPER مدیریت کنید.
مرجع‌ها
برای اطلاعات بیشتر، به موارد زیر مراجعه کنید: