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

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

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

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

    ~/shopping-samples/content/

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

    1. در Merchant Center ، در منوی تنظیمات ، Content API را انتخاب کنید.
    2. روی Authentication کلیک کنید.
    3. روی [+] CREATE API KEY کلیک کنید.
    4. در صورت درخواست، شرایط قراردادهای خدمات را بخوانید و بپذیرید.

    کلید جدید به صورت خودکار دانلود می شود.

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

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

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

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

    {
    "merchantId": your Merchant Center merchant ID,
    "accountSampleUser": "the email address associated with your Merchant Center account"
    }
    
  7. مخزن googleads/googleads-shopping-samples GitHub را شبیه سازی کنید (یا دانلود و از حالت فشرده خارج کنید) در هر مکانی در رایانه شما. لازم نیست در فهرست اصلی شما یا در ~/shopping-samples/content/ باشد.

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

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

    pip install -r requirements.txt
    

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