إجراء طلب بيانات من واجهة برمجة التطبيقات

يحتوي مستودع googleads/googleads-shopping-samples على GitHub على عيّنات من الرموز البرمجية للعمليات الشائعة لكل مكتبة من مكتبات البرامج. على سبيل المثال، تقدّم النماذج في googleads-shopping-samples/python/shopping/content/products/ رمزًا برمجيًا لعمليات شائعة باستخدام مصدر products مع Python. في هذا الدليل، ستبدأ بملف فارغ وتنشئ مثالاً يضيف منتجًا جديدًا، وذلك لتتمكّن من الاطّلاع على البنية الأساسية والمكوّنات المطلوبة للتطبيقات التي تتكامل مع Content API. ستكون النتيجة النهائية مشابهة للمثال الوارد في ملف النموذج products/insert.py. يمكنك بعد ذلك استخدام مستكشف واجهات برمجة التطبيقات لطريقة products.list للتأكّد من أنّه تمت إضافة المنتج بنجاح.

لإجراء مكالمتك الأولى، أكمل الخطوات التالية:

1. في الدليل googleads-shopping-samples/python/shopping/content/products/‎، أنشئ ملفًا فارغًا باسم my-insert.py. أضِف كل الرموز في الخطوات التالية إلى هذا الملف.

2. أضِف عبارات الاستيراد للوحدات المطلوبة.

   في بداية 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، وتحصل على معرّف التاجر من ملف الإعداد، وتنشئ الطلب، وتنفّذ الطلب لإجراء طلب البيانات من واجهة برمجة التطبيقات.

   في نهاية 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. لتشغيل النص البرمجي وتنفيذ طلب البيانات من واجهة برمجة التطبيقات، انتقِل من نافذة طرفية إلى googleads-shopping-samples/python/‎ وشغِّل ما يلي:

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

   إذا نجحت المكالمة، ستعرض الخدمة الرسالة التالية في نافذة الأوامر: تم إنشاء المنتج الذي يحمل رقم تعريف العرض "offerId".

6. للتأكّد من أنّه تمت إضافة المنتج بنجاح، استخدِم "مستكشف واجهات برمجة التطبيقات" مع الطريقة products.list لعرض جميع المنتجات في حسابك على Merchant Center.

   في API Explorer لطريقة products.list، أدخِل القيم التالية:

   1. أدخِل merchantId.
   1. في قسم بيانات الاعتماد، اختَر Google OAuth 2.0 ومفتاح واجهة برمجة التطبيقات.
   2. انقر على الزر تنفيذ.
   3. سجِّل الدخول باستخدام حساب Google المرتبط بحسابك على Merchant Center عندما يُطلب منك ذلك.

   إذا تمت إضافة المنتج بنجاح، ستظهر بيانات المنتج في استجابة "مستكشف واجهة برمجة التطبيقات".

يتحمّل التجّار مسؤولية الالتزام بسياسات إعلانات Shopping والبيانات المجانية. يحتفظ محرّك بحث Google Shopping بالحق في فرض هذه السياسات واتّخاذ الإجراءات اللازمة إذا عثرنا على محتوى أو سلوك يخالف هذه السياسات.