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

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

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

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

   ~/shopping-samples/content/

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.

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. בקטע הבא יוצרים ושולחים בקשה להוספת מוצר חדש.