הגדרה של ספריית לקוח

מומלץ להשתמש בספריות הלקוח של Google API כדי להגדיר את Content API for Shopping. המדריך הזה משתמש בספריות הלקוח של Python Content API כדוגמה, אבל הן זמינות בשפות תכנות נפוצות רבות, ומפשטות משימות נפוצות ב-API כמו אימות, שליחת בקשות וניתוח של התשובות. לקבלת עזרה בהגדרת ספריות לקוח לשפות אחרות, תוכלו לעיין ב-README.md לשפה בתוך googleads/googleads-shopping-sample עבור GitHub.

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

כדי להגדיר את ספריית הלקוחות של Google API עבור Python, מבצעים את השלבים הבאים:

1. יצירת ספרייה לקובצי התצורה והאימות של ספריית הלקוח. בספריית הבית, יוצרים את הספריות הבאות:

   ~/shopping-sample/content/

   הערה: הנתיב הזה, יחד עם שם הקובץ עבור הקובץ merchant-info.json שנוצר בשלב 5, מוגדרים בקובץ python/shopping/content/COMMON.py בתוך ספריית הדוגמאות של Content API שהורדתם בשלב 7.

2. כך מורידים את פרטי הכניסה של חשבון השירות:

   1. ב-Merchant Center, בתפריט Settings (הגדרות), בוחרים באפשרות Content API.
   2. לוחצים על אימות.
   3. לוחצים על [+] יצירת מפתח API.
   4. אם תתבקשו, עליכם לקרוא ולאשר את התנאים וההגבלות.

   ההורדה של המפתח החדש תתבצע באופן אוטומטי.

3. משנים את שם הקובץ של פרטי הכניסה שהורדתם ל-service-account.json.

   הערה: שם הקובץ הזה מוגדר בקובץ _regulars.py, שנמצא ב-python/shopping/content/ בספריית הדוגמאות של Content API שהורדתם בשלב 7.

4. מעבירים את הקובץ service-account.json אל home directory/shopping-sample/content/.

5. ב-home directory/shopping-sample/content/ , יוצרים קובץ merchant-info.json ריק.

6. ב-merchant-info.json, מוסיפים את הטקסט הבא:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

7. שכפול (או הורדה וביטול הדחיסה של) ה-googleads/googleads-shopping-sample דוח GitHub בכל מיקום במחשב. הוא לא חייב להיות בספריית הבית או ב~/shopping-sample/content/.

8. אם הורדתם את קובץ ה-repo וביטלתם אותו במקום לדחוס אותו, עליכם לשנות את השם של המאגר ל-googleads-shopping-sample.

9. כדי להתקין את יחסי תלות לדוגמה, בחלון Terminal, מנווטים אל googleads-shopping-sample/python/ ומפעילים:

   pip install -r requirements.txt
   

ספריית ה-API של Google API עבור Python מוגדרת ו מוכנה לשימוש עם ה-Content API. בשלב הבא תצרו ותשלחו בקשה להוספת מוצר חדש.