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

يحتوي مستودع googleads/googleads-shopping- sample على 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/، أنشئ ملف googleads-shopping-samples/python/shopping/content/products/ فارغ. أضف كل التعليمات البرمجية في الخطوات التالية إلى هذا الملف.

  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 المرتبط بحسابك على Merchant Center إذا طُلب منك ذلك.

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

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

السابق
إعداد مكتبة عملاء
التالي
استكشاف Content API