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

googleads/googleads-shopping-samples يحتوي المستودع على GitHub على نموذج رمز برمجي للعمليات الشائعة لكل عميل. المكتبة. على سبيل المثال، العينات الموجودة في googleads-shopping-samples/python/shopping/content/products/ توفير الرمز للعمليات المشتركة باستخدام products في لغة بايثون. في هذا الدليل، تبدأ بملف فارغ وتنشئ مثال يُدرج منتجًا جديدًا، بحيث يمكنك رؤية الأساسيات الهيكل والمكونات المطلوبة للتطبيقات التي تتكامل مع 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. في قسم Credentials (بيانات الاعتماد)، اختَر Google OAuth 2.0 ومفتاح واجهة برمجة التطبيقات.
   2. انقر على الزر تنفيذ.
   3. سجِّل الدخول باستخدام حساب Google المرتبط بالتاجر إذا طُلب منك ذلك. حسابك على Google Center.

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

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