یک کتابخانه مشتری راه اندازی کنید

توصیه می کنیم از کتابخانه های سرویس گیرنده Google API برای راه اندازی Content API برای خرید استفاده کنید. این راهنما از کتابخانه های کلاینت Python Content API به عنوان مثال استفاده می کند، اما آنها برای بسیاری از زبان های برنامه نویسی محبوب در دسترس هستند و وظایف رایج API مانند احراز هویت، ارسال درخواست ها و تجزیه پاسخ ها را ساده می کنند. برای راهنمایی در راه‌اندازی کتابخانه‌های مشتری برای زبان‌های دیگر، به README.md برای زبان موجود در مخزن googleads/googleads-shopping-samples در GitHub مراجعه کنید.

برای راه اندازی کتابخانه سرویس گیرنده Google API برای پایتون، مراحل زیر را انجام دهید:

1. یک دایرکتوری برای فایل های پیکربندی و احراز هویت کتابخانه مشتری ایجاد کنید. در فهرست اصلی خود، دایرکتوری های زیر را ایجاد کنید:

   ~/shopping-samples/content/

2. برای دانلود اعتبار حساب سرویس خود، مراحل زیر را انجام دهید:

   1. به کتابخانه Google API بروید.
   2. یک پروژه را در منوی بالای صفحه انتخاب کنید. اگر هنوز یکی را ندارید، با کلیک کردن روی پروژه جدید، یکی ایجاد کنید.
   3. اگر قبلاً Content API را برای خرید برای این پروژه فعال نکرده‌اید، آن را در فهرست APIهای Google جستجو کنید و آن را فعال کنید.
   4. در نوار کناری سمت چپ، اعتبارنامه ها را انتخاب کنید. برای دیدن این مورد ممکن است لازم باشد روی فلش سمت چپ در بالا سمت چپ کلیک کنید.
   5. برای تنظیم یک حساب سرویس، Create credentials و سپس Service account را انتخاب کنید.
   6. حساب سرویس جدید را نام ببرید. این همچنین به عنوان نام کاربری پیش‌فرض برای شناسه حساب سرویس عمل می‌کند. شناسه حساب سرویس، از جمله قسمت بعد از نویسه «@» را برای استفاده بعدی ضبط کنید. روی ایجاد کلیک کنید، سپس مراحل اختیاری اعطای دسترسی به پروژه و کاربران را طی کنید و روی Done کلیک کنید.
   7. به صفحه حساب‌های خدمات هدایت می‌شوید، جایی که می‌توانید به حساب سرویس جدیدتان دسترسی پیدا کنید.

3. برای به دست آوردن یک کلید خصوصی JSON، روی حساب سرویس و سپس برگه کلیدها کلیک کنید. روی افزودن کلید > ایجاد کلید جدید کلیک کنید و سپس JSON را به عنوان نوع کلید انتخاب کنید. برای دانلود کلید خصوصی در رایانه خود روی Create کلیک کنید. کلید جدید به صورت خودکار دانلود می شود.

4. نام فایل اعتبار دانلود شده را به service-account.json تغییر دهید.

5. فایل service-account.json را به home directory /shopping-samples/content/ منتقل کنید.

6. در home directory خود /shopping-samples/content/ ، یک فایل merchant-info.json خالی ایجاد کنید.

7. در merchant-info.json ، متن زیر را اضافه کنید:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

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

   1. به حساب Merchant Center خود بروید.
   2. در تنظیمات حساب Merchant Center خود، افراد را انتخاب کنید و به آن دسترسی داشته باشید .

   3. روی + افزودن شخص کلیک کنید و از شناسه حساب سرویس به عنوان آدرس ایمیل کاربر جدید استفاده کنید.

   4. استفاده از سرویس Accounts به دسترسی Admin نیاز دارد، بنابراین Admin را انتخاب کنید.

   5. برای ذخیره تنظیمات برگزیده و بازگشت به لیست کاربران، روی افزودن کاربر کلیک کنید. شناسه حساب سرویس با نقش کاربر انتخابی فهرست شده است.

   6. این فرآیند را برای همه حساب‌های سرویس دیگری که می‌خواهید اضافه کنید، تکرار کنید.

9. مخزن googleads/googleads-shopping-samples GitHub را شبیه سازی کنید (یا دانلود و از حالت فشرده خارج کنید) در هر مکانی در رایانه شما. لازم نیست در فهرست اصلی شما یا در ~/shopping-samples/content/ باشد.

10. اگر مخزن را دانلود و از حالت فشرده خارج کرده اید، به جای شبیه سازی آن، نام دایرکتوری زیپ نشده را به googleads-shopping-samples تغییر دهید.

11. برای نصب وابستگی های نمونه مورد نیاز، در یک پنجره ترمینال، به googleads-shopping-samples/python/ بروید و اجرا کنید:

    pip install -r requirements.txt
    

اکنون کتابخانه سرویس گیرنده Google API برای Python را پیکربندی کرده و آماده استفاده با Content API دارید. در بخش بعدی، درخواستی برای درج یک محصول جدید ایجاد و ارسال خواهید کرد.