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

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

לקבלת מידע על האופן שבו Merchant API יכול לשפר את השילוב שלכם ועל האופן שבו תוכלו לעזור לעצב את בעתיד, ראו הכרזה גרסת הבטא של Merchant API.

מומלץ להשתמש ספריות לקוח של Google API להגדרה ב-Content API for Shopping. במדריך הזה אנחנו משתמשים בלקוח Python Content API ספריות לדוגמה, אבל הן זמינות בתוכניות פופולריות רבות ולפשט משימות API נפוצות כמו אימות, שליחת בקשות, וניתוח התגובות. לקבלת עזרה בהגדרת ספריות לקוח עבור שפות אחרות, עיין ב-README.md עבור השפה שבתוך googleads/googleads-shopping-samples במאגר ב-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. נכנסים אל ספריית Google API.
   2. בוחרים פרויקט בתפריט שבחלק העליון של הדף. אם אין לך חשבון עדיין יוצרים פרויקט על ידי לחיצה על פרויקט חדש.
   3. אם עדיין לא הפעלתם את Content API for Shopping לצורך כך בפרויקט הרלוונטי, מחפשים אותו ברשימת ממשקי ה-API של Google ומפעילים אותו.
   4. בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה. יכול להיות שתצטרכו ללחוץ כדי לראות זאת, לחץ על החץ שמאלה בצד ימין למעלה.
   5. כדי להגדיר חשבון שירות, בוחרים באפשרות יצירת פרטי כניסה, ואז חשבון שירות.
   6. נותנים שם לחשבון השירות החדש. הוא משמש גם כשם המשתמש שמוגדר כברירת מחדל, מספר חשבון השירות. שומרים את מזהה חשבון השירות, כולל החלק אחרי '@' לשימוש אחר. לוחצים על יצירה, ואז השלבים האופציונליים של הענקת גישה לפרויקט ולמשתמשים, ולוחצים על בוצע.
   7. תתבצע הפניה לדף 'חשבונות שירות' שבו ניתן למצוא את השירות החדש ניתן לגשת לחשבון.

3. כדי לקבל מפתח פרטי של JSON, לוחצים על חשבון השירות ואז על Keys. . לוחצים על Add key > Create new key, ואז בוחרים JSON בתור סוג המפתח. לוחצים על יצירה כדי להוריד את המפתח הפרטי למחשב. ההורדה של המפתח החדש תתבצע באופן אוטומטי.

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

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

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

6. בקטע home directory/shopping-Sample/content/, יוצרים הקובץ merchant-info.json ריק.

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

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

8. מוסיפים את חשבון השירות החדש כמשתמש לחשבון Merchant Center. אם מפתחי צד שלישי, תצטרכו לבקש מהלקוח לבצע את השלב הזה עבורך.

   1. נכנסים אל חשבון Merchant Center.
   2. בהגדרות של חשבון Merchant Center, בוחרים באפשרות אנשים גישה.

   3. לוחצים על + הוספת משתמש ומשתמשים במזהה חשבון השירות בתור כתובת האימייל. עבור המשתמש החדש.

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

   4. כדי להשתמש בשירות Accounts נדרשת הרשאת אדמין, לכן צריך לבחור ניהול.

   5. לוחצים על הוספת משתמש כדי לשמור העדפות ולחזור לרשימה של משתמשים. מזהה חשבון השירות מופיע עם תפקיד המשתמש שנבחר.

   6. חוזרים על התהליך עם כל חשבונות השירות שרוצים להוסיף.

9. משכפלים (או מורידים ומחלצים) את קובץ ה-ZIP googleads/googleads-shopping-samples מאגר GitHub לכל מיקום במחשב שלך; הוא לא חייב להיות ספריית הבית או בקטע ~/shopping-samples/content/.

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

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

    pip install -r requirements.txt
    

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