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

אנחנו רוצים להציג את גרסת הבטא של Merchant API. זאת הגרסה החדשה של ה-Content API, של העתיד.

מומלץ להשתמש בספריות הלקוח של 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-samples/content/

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

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

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

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

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

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

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

5. ב-home directory/shopping-samples/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. משכפלים (או מורידים ומחלצים את קובץ ה-ZIP) של המאגר googleads/googleads-shopping-samples ב-GitHub לכל מיקום במחשב; הוא לא חייב להיות בספריית הבית או ב-~/shopping-samples/content/.

8. אם הורדתם את המאגר וחילצתם אותו, במקום לשכפל אותו, שנו את השם של הספרייה לא דחוסה בקובץ ZIP ל-googleads-shopping-samples.

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

   pip install -r requirements.txt
   

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