ביצוע קריאה ל-API

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

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

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

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

    ב-API Explorer ל-method products.list, מזינים את הערכים הבאים:

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

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

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

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