این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نمای کلی

برای استفاده موثر از Merchant API، درک مفاهیم ثبت، احراز هویت و مجوز مهم است. آنها اهداف مشخصی را در تضمین دسترسی ایمن و صحیح به داده های Merchant Center انجام می دهند.

اصطلاحات

ثبت، احراز هویت و مجوز مرتبط هستند، اما هر کدام معنا و هدف مشخصی دارند.

احراز هویت : در این فرآیند، سرویس هویت کاربر یا برنامه‌ای را که درخواست API می‌کند، تأیید می‌کند. 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 Project : برنامه شما باید با پروژه 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 خود را پیدا کنید

می‌توانید ID پروژه و شماره پروژه خود را در Google Cloud Console پیدا کنید. برای جزئیات، به یافتن نام، شماره و شناسه پروژه مراجعه کنید.

برای ثبت نام تماس بگیرید

با استفاده از متد registerGcp در زیر API Accounts ثبت نام کنید. این تماس شماره پروژه Google Cloud شما را با حساب Merchant Center مرتبط می‌کند.

در طول فرآیند، باید یک آدرس ایمیل مرتبط با یک کاربر جداگانه ارائه کنید که از آن برای فراخوانی API استفاده می کنید. این ایمیل باید متعلق به کاربری با دسترسی ادمین به حساب Merchant Center باشد.

درباره فیلد ایمیل

ارتباط موثر کلیدی است. Google به‌روزرسانی‌های مهم، اعلان‌های خدمات اجباری (MSA)، نظرسنجی‌های توسعه‌دهندگان و سایر فرصت‌های مرتبط با Merchant API را ارسال می‌کند. مدیریت مناسب تماس تضمین می کند که این افراد به افراد مناسب می رسند.

هدف : Google از این آدرس ایمیل به عنوان مخاطب اصلی برای ارتباطات مرتبط با API استفاده می کند.
ایمیل چه کسی : این باید آدرس ایمیل یک توسعه دهنده فردی یا یک مخاطب فنی کلیدی باشد که مسئول ادغام API است.
بهترین روش ها :
- انجام دهید : از آدرس ایمیل شرکتی یک فرد استفاده کنید.
- نباید : از نام مستعار عمومی یا ایمیل های حساب سرویس استفاده کنید. ما در نظر داریم برای گیرندگان انسانی ارتباط برقرار کنیم.

منابع `users` برای مدیریت تماس

در حالی که آدرس ایمیل در تماس ثبت نام، یک مخاطب اولیه را تنظیم می‌کند، راه قوی‌تر برای مدیریت مخاطبین و مجوزها استفاده از منبع Merchant API accounts.users یا تنظیمات مدیریت کاربر در Merchant Center UI است. برای اطلاعات بیشتر در مورد استفاده از Merchant Center، به مدیریت افراد در حساب خود مراجعه کنید.

از این ویژگی ها به شرح زیر استفاده کنید:

افزودن همه برنامه‌نویس‌ها : توسعه‌دهندگانی را که روی ادغام API کار می‌کنند، به عنوان کاربران حساب Merchant Center اضافه کنید.
نقش API_DEVELOPER را تعیین کنید : علاوه بر نقش‌های استاندارد ( مدیر ، استاندارد )، می‌توانید نقش API_DEVELOPER را به کاربران اختصاص دهید. به ویژه، این نقش را به کاربرانی که باید ارتباطات مرتبط با API را دریافت کنند، اختصاص دهید. می توانید آن را با نقش های دیگر ترکیب کنید.
مزایا :
- پاک کردن جداسازی : مدیریت تماس API را از ثبت یکباره جدا می کند.
- انعطاف پذیری : با تغییر اعضای تیم، مخاطبین را به روز کنید.
- ارتباط هدفمند : اطمینان حاصل می کند که اخبار ویژه API به افراد مربوطه می رسد.