یک تماس API برقرار کنید

مخزن googleads/googleads-shopping-samples در GitHub حاوی کد نمونه برای عملیات رایج برای هر کتابخانه مشتری است. برای مثال، نمونه‌های موجود در googleads-shopping-samples/python/shopping/content/products/ کدی را برای عملیات رایج با استفاده از منبع products با پایتون ارائه می‌کنند. در این راهنما، شما با یک فایل خالی شروع می‌کنید و نمونه‌ای ایجاد می‌کنید که یک محصول جدید را درج می‌کند تا بتوانید ساختار اصلی و اجزای مورد نیاز برنامه‌هایی را که با Content API یکپارچه می‌شوند، ببینید. نتیجه نهایی مشابه نمونه فایل نمونه products/insert.py خواهد بود. سپس می توانید از API Explorer برای روش products.list استفاده کنید تا تأیید کنید که محصول با موفقیت اضافه شده است.

برای برقراری اولین تماس، مراحل زیر را انجام دهید:

1. در فهرست راهنمای googleads-shopping-samples/python/shopping/content/products/ ، یک فایل خالی my-insert.py ایجاد کنید. تمام کدها را در مراحل زیر به این فایل اضافه کنید.

2. دستورهای import را برای ماژول های مورد نیاز اضافه کنید.

   در ابتدای my-insert.py کد زیر را اضافه کنید:

   from __future__ import print_function
   import sys
   
   # The common module provides setup functionality used by the samples,
   # such as authentication and unique id generation.
   from shopping.content import common
   

3. یک شناسه محصول منحصر به فرد تعریف کنید و یک فرهنگ لغت با تعریف محصول ایجاد کنید.

   در انتهای my-insert.py کد زیر را اضافه کنید:

   offer_id = 'book#%s' % common.get_unique_id()
   product = {
        'offerId':
            offer_id,
        'title':
            'A Tale of Two Cities',
        'description':
            'A classic novel about the French Revolution',
        'link':
            'http://my-book-shop.com/tale-of-two-cities.html',
        'imageLink':
            'http://my-book-shop.com/tale-of-two-cities.jpg',
        'contentLanguage':
            'en',
        'targetCountry':
            'US',
        'channel':
            'online',
        'availability':
            'in stock',
        'condition':
            'new',
        'googleProductCategory':
            'Media > Books',
        'gtin':
            '9780007350896',
        'price': {
            'value': '2.50',
            'currency': 'USD'
        },
        'shipping': [{
            'country': 'US',
            'service': 'Standard shipping',
            'price': {
                'value': '0.99',
                'currency': 'USD'
            }
        }],
        'shippingWeight': {
            'value': '200',
            'unit': 'grams'
        }
   }
   

4. یک تابع ایجاد کنید که هنگام اجرای اسکریپت از خط فرمان اجرا شود. این تابع یک شیء سرویس را برای تعامل با Content API می سازد، شناسه فروشنده را از فایل پیکربندی دریافت می کند، درخواست را می سازد و درخواست را برای برقراری فراخوانی API اجرا می کند.

   در انتهای my-insert.py کد زیر را اضافه کنید:

   def main(argv):
     # Construct the service object to interact with the Content API.
     service, config, _ = common.init(argv, __doc__)
   
     # Get the merchant ID from merchant-info.json.
     merchant_id = config['merchantId']
   
     # Create the request with the merchant ID and product object.
     request = service.products().insert(merchantId=merchant_id, body=product)
   
     # Execute the request and print the result.
     result = request.execute()
     print('Product with offerId "%s" was created.' % (result['offerId']))
   
   # Allow the function to be called with arguments passed from the command line.
   if __name__ == '__main__':
     main(sys.argv)
   
   

5. برای اجرای اسکریپت و اجرای فراخوانی API، از پنجره ترمینال، به googleads-shopping-samples/python/ بروید و اجرا کنید:

   python -m shopping.content.products.my-insert
   

   اگر تماس با موفقیت انجام شد، سرویس پیام زیر را در ترمینال چاپ می کند: محصول با offerId " offerId " ایجاد شد.

6. برای تأیید اینکه محصول با موفقیت اضافه شده است، از API Explorer برای روش products.list استفاده کنید تا همه محصولات موجود در حساب Merchant Center خود را برگردانید.

   در روش API Explorer for the products.list ، مقادیر زیر را وارد کنید:

   1. merchantId خود را وارد کنید.
   1. در بخش اعتبارنامه ، Google OAuth 2.0 و کلید API را انتخاب کنید.
   2. روی دکمه Execute کلیک کنید.
   3. اگر از شما خواسته شد، با حساب Google مرتبط با حساب Merchant Center خود وارد شوید.

   اگر محصول با موفقیت اضافه شد، داده های محصول در پاسخ کاوشگر API ظاهر می شود.

تاجران مسئول پیروی از خط‌مشی‌های تبلیغات خرید و فهرست‌های رایگان هستند. Google Shopping این حق را برای خود محفوظ می‌دارد که این خط‌مشی‌ها را اجرا کند و در صورت مشاهده محتوا یا رفتاری که این خط‌مشی‌ها را نقض می‌کند، به آن پاسخ مناسب بدهد.