راهنمای شروع سریع برای Merchant API

این صفحه توضیح می‌دهد که چگونه می‌توانید یک حساب مرکز فروشندگان ایجاد کنید و یک محصول نمونه را با استفاده از API فروشندگان آپلود کنید.

قبل از اینکه شروع کنی

رابط برنامه‌نویسی کاربردی فروشنده (Merchant API) را در پروژه گوگل کلود خود فعال کنید. برای احراز هویت به آن نیاز خواهید داشت.

آیا من یک پروژه گوگل کلود دارم؟

اگر از ادغام API در Apps Script با استفاده از سرویس محتوای خرید استفاده کنید، یک پروژه پیش‌فرض Google Cloud ایجاد می‌شود و سرویس Merchant API به طور خودکار فعال می‌شود. با این حال، قبل از استفاده از Merchant API، هنوز باید یک ثبت‌نام توسعه‌دهنده یکباره انجام دهید. برای اطلاعات بیشتر، به استفاده از سرویس Merchant API در Apps Script مراجعه کنید.

در غیر این صورت، اگر پروژه گوگل کلود ندارید، می‌توانید یک پروژه گوگل کلود ایجاد کنید .

به فضای ابری گوگل بروید

مرحله 1. ایجاد یک حساب کاربری در مرکز بازرگانان

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

به مرکز تجاری بروید

مرحله ۲. تنظیم احراز هویت برای API فروشنده

بهترین روش برای تنظیم احراز هویت بستگی به محیطی دارد که قصد دارید در آن کار کنید:

  • اگر ارائه‌دهنده شخص ثالث هستید، برنامه خود را طوری تنظیم کنید که با استفاده از OAuth 2.0 به حساب‌های مرکز فروشندگان مشتریان شما دسترسی داشته باشد. برای جزئیات بیشتر به بخش «دسترسی به حساب‌های مشتری» مراجعه کنید. برای ثبت‌نام، باید یک توکن OAuth برای حساب گوگل خود دریافت کنید.
  • اگر در حال توسعه یک برنامه داخلی هستید که فقط به حساب مرکز فروشندگان شما نیاز دارد، به جای آن به بخش دسترسی به حساب خود مراجعه کنید.

مرحله ۳: نحوه تعامل با API فروشنده را تعیین کنید.

دو رویکرد برای تعامل با Merchant API وجود دارد:

فراخوانی‌های مستقیم API

درخواست‌های خام را مستقیماً به نقاط انتهایی API، معمولاً از طریق HTTP(S) ارسال کنید. شما به صورت دستی تشکیل بدنه درخواست، تنظیم هدرها (از جمله احراز هویت) و تجزیه پاسخ را انجام می‌دهید.

راهنمای فراخوانی‌های مستقیم API

کتابخانه‌های کلاینت

از کتابخانه‌های از پیش ساخته شده استفاده کنید که جزئیات سطح پایین مربوط به ایجاد درخواست‌ها و مدیریت پاسخ‌ها را کپسوله‌سازی می‌کنند. آن‌ها احراز هویت، سریال‌سازی درخواست/پاسخ و سایر کدهای تکراری را مدیریت می‌کنند.

راهنمای کتابخانه‌های مشتری