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

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

توجه: برای استفاده از کد نمونه در پایتون، باید چندین کتابخانه مورد نیاز را نصب کنید. به همین دلیل، توصیه می‌کنیم قبل از ادامه، یک محیط مجازی پایتون ایجاد کنید. برای اطلاعات بیشتر، به نصب بسته‌ها با استفاده از pip و محیط‌های مجازی مراجعه کنید.

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

1. یک دایرکتوری برای فایل‌های پیکربندی و احراز هویت کتابخانه کلاینت ایجاد کنید. در دایرکتوری خانگی خود، دایرکتوری‌های زیر را ایجاد کنید:

   ~/نمونه‌های خرید/محتوا/

   توجه: این مسیر، و همچنین نام فایل merchant-info.json که در مرحله ۵ ایجاد شده است، در فایل python/shopping/content/common.py در دایرکتوری نمونه‌های API محتوا که در مرحله ۷ دانلود شده است، تعریف شده‌اند.

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

   1. به کتابخانه API گوگل بروید.
   2. یک پروژه را از منوی بالای صفحه انتخاب کنید. اگر هنوز پروژه‌ای ندارید، با کلیک روی «پروژه جدید» آن را ایجاد کنید.
   3. اگر هنوز API محتوا برای خرید را برای این پروژه فعال نکرده‌اید، آن را در فهرست APIهای گوگل جستجو کنید و فعال کنید.
   4. روی منوی ناوبری (☰) در بالا سمت چپ کلیک کنید، APIها و خدمات (APIs & Services ) و سپس اعتبارنامه‌ها (Credentials) را انتخاب کنید.
   5. برای تنظیم یک حساب کاربری سرویس، گزینه ایجاد اعتبارنامه و سپس حساب کاربری سرویس را انتخاب کنید.
   6. نام حساب سرویس جدید را وارد کنید. این نام همچنین به عنوان نام کاربری پیش‌فرض برای شناسه حساب سرویس عمل می‌کند. شناسه حساب سرویس، از جمله قسمت بعد از کاراکتر '@' را برای استفاده‌های بعدی یادداشت کنید. روی ایجاد کلیک کنید، سپس مراحل اختیاری اعطای دسترسی به پروژه و کاربران را طی کنید و روی انجام شد کلیک کنید.
   7. شما به صفحه حساب‌های سرویس هدایت خواهید شد که در آنجا می‌توانید به حساب سرویس جدید خود دسترسی پیدا کنید.

3. برای دریافت کلید خصوصی JSON، روی حساب کاربری سرویس و سپس تب Keys کلیک کنید. روی Add key > Create new key کلیک کنید و سپس JSON را به عنوان نوع کلید انتخاب کنید. برای دانلود کلید خصوصی روی رایانه خود، روی Create کلیک کنید. کلید جدید به صورت خودکار دانلود می‌شود.

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

   نکته: این نام فایل در فایل _constants.py تعریف شده است که در مسیر python/shopping/content/ در پوشه‌ی نمونه‌های API محتوا که در مرحله‌ی ۷ دانلود شده است، قرار دارد.

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. حساب سرویس جدید را به عنوان کاربر به حساب مرکز فروشندگان خود اضافه کنید. اگر شما یک توسعه‌دهنده شخص ثالث هستید، باید از مشتری خود بخواهید این مرحله را برای شما انجام دهد.

   1. به حساب مرکز بازرگانان خود بروید.
   2. در تنظیمات حساب مرکز فروشندگان خود، گزینه «افراد» را انتخاب کرده و به آن دسترسی پیدا کنید .

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

      نکته: اگر قبلاً شناسه حساب سرویس را یادداشت نکرده‌اید، به صفحه مدیریت حساب‌های سرویس بروید و پروژه‌ای را که ایجاد کرده‌اید انتخاب کنید.

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

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

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

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

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

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

    pip install -r requirements.txt
    

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