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

אנחנו שמחים להציג את Merchant API (בטא) – הדור הבא של Content API for Shopping.

קבלת העדכונים האחרונים על תכונות חדשות, תיקוני באגים ועדכוני גרסאות של Merchant API (בטא).

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

מומלץ להשתמש בספריות הלקוח של 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. בוחרים פרויקט בתפריט שבחלק העליון של הדף. אם עדיין אין לכם פרויקט, תוכלו ליצור אחד בלחיצה על New project.
   3. אם עדיין לא הפעלתם את Content API for Shopping בפרויקט הזה, מחפשים אותו ברשימת Google APIs ומפעילים אותו.
   4. בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה. יכול להיות שתצטרכו ללחוץ על החץ שמצביע שמאלה בפינה הימנית העליונה כדי לראות את האפשרות הזו.
   5. כדי להגדיר חשבון שירות, בוחרים באפשרות Create credentials ואז באפשרות Service account.
   6. נותנים שם לחשבון השירות החדש. השם הזה משמש גם בתור שם המשתמש שמוגדר כברירת מחדל למזהה של חשבון השירות. שומרים את מזהה חשבון השירות, כולל החלק אחרי התו '@', לשימוש מאוחר יותר. לוחצים על Create, מבצעים את השלבים האופציונליים להענקת גישה לפרויקט ולמשתמשים ולוחצים על Done.
   7. תועברו לדף חשבונות השירות, שבו תוכלו לגשת לחשבון השירות החדש.

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

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

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

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

6. יוצרים קובץ merchant-info.json ריק בתיקייה home directory/shopping-samples/content/.

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. לוחצים על + Add person ומשתמשים במזהה של חשבון השירות ככתובת האימייל של המשתמש החדש.

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

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

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

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

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

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

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

    pip install -r requirements.txt
    

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