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

يحتوي مستودع 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 عندما يُطلب منك ذلك.

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

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

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