קריאה ל-API

מאגר ה-googleads/googleads-shopping-sample ב-GitHub כולל קוד לדוגמה לפעולות נפוצות בכל ספריית לקוח. לדוגמה, הדוגמאות ב-googleads-shopping-sample/python/shopping/content/products/ מספקות קוד לפעולות נפוצות באמצעות המשאב products עם Python. במדריך הזה אתם מתחילים עם קובץ ריק ובונים דוגמה שמוסיפה מוצר חדש, כדי שתוכלו לראות את המבנה הבסיסי ואת הרכיבים הנדרשים של אפליקציות שמשתלבות עם ה-Content API. התוצאה הסופית תהיה דומה לדוגמה בקובץ לדוגמה products/insert.py. לאחר מכן תוכלו להשתמש ב-API Explorer עבור השיטה 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, מקבלת את מזהה המוכר מקובץ התצורה, בונה את הבקשה ומבצעת את הבקשה לביצוע קריאת ה-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. כדי להריץ את הסקריפט ולבצע את הקריאה ל-API, נכנסים למסוף googleads-shopping-sample/python/ ומריצים:

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

    אם השיחה הסתיימה בהצלחה, השירות מדפיס את ההודעה הבאה למסוף: נוצר מוצר עם מזהה המבצע "offerId".

  6. כדי לוודא שהמוצר נוסף בהצלחה, השתמשו בסייר ה-API עבור השיטה products.list כדי להחזיר את כל המוצרים בחשבון Merchant Center.

    בAPI Explorer של השיטה products.list, הזינו את הערכים הבאים:

    1. יש להזין את merchantId.
    1. בקטע Credentials, בוחרים באפשרות Google OAuth 2.0 ו-API key.
    2. לוחצים על הלחצן ביצוע.
    3. אם מתבקשים, נכנסים לחשבון Google המשויך לחשבון Merchant Center.

    אם המוצר נוסף בהצלחה, נתוני המוצרים יופיעו בתשובה של חוקר ה-API.

המוכרים אחראים לפעול בהתאם למדיניות בנושא מודעות שופינג וכרטיסי מוצר חינמיים. Google שופינג שומרת לעצמה את הזכות לאכוף את כללי המדיניות האלה ולהגיב בהתאם, אם אנחנו מוצאים תוכן או התנהגות שמפרים את המדיניות הזו.

הקודם
הגדרה של ספריית לקוחות
הבא
עיון ב-Content API