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

يحتوي الريبو 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.

   في مستكشف واجهات برمجة التطبيقات لطريقة products.list، أدخِل القيم التالية:

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

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

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