חשבונות השירות

חשבונות שירות הם חשבונות Google מיוחדים שאפליקציות יכולות להשתמש בהם באופן פרוגרמטי כדי לגשת ל-Google APIs דרך OAuth 2.0. בחשבון שירות נעשה שימוש בתהליך OAuth 2.0 שלא מחייב הרשאה אנושית. במקום זאת, היא משתמשת בקובץ מפתח שרק לאפליקציה שלכם יש גישה אליו. במדריך הזה מוסבר איך לגשת ל-Content API for Shopping באמצעות חשבונות שירות.

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

דרישות מוקדמות

• חשבון Merchant Center.

שלבים לשימוש בחשבון שירות כדי לגשת ל-Content API for Shopping

1. יוצרים פרטי כניסה לחשבון שירות או ניגשים לפרטי הכניסה הציבוריים שכבר יצרתם. תצטרכו ליצור מזהה לקוח ב-OAuth 2.0 ולקבל קובץ מפתח פרטי מסוג *.json:
   1. נכנסים למסוף Google API.
   2. בוחרים פרויקט בתפריט הנפתח שבחלק העליון של הדף. אם עדיין אין לכם פרויקט, לוחצים על NEW PROJECT (פרויקט חדש).
   3. אם עדיין לא הפעלתם את Content API for Shopping בפרויקט הזה, חפשו אותו ברשימת ממשקי Google API והפעילו אותו.
   4. בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה. כדי לראות את האפשרות הזו, יכול להיות שתצטרכו ללחוץ על החץ שמאלה בפינה הימנית העליונה.
   5. כדי להגדיר חשבון שירות, בוחרים באפשרות CREATE CREDENTIALS, ואז Service account.
      
   6. נותנים שם לחשבון השירות החדש. הוא משמש גם כשם המשתמש שמוגדר כברירת מחדל למזהה של חשבון השירות. שומרים את מזהה חשבון השירות, כולל החלק אחרי התו '@', לשימוש מאוחר יותר. לוחצים על CREATE ואז מבצעים את השלבים האופציונליים של הענקת גישה לפרויקט ולמשתמשים, ולוחצים על DONE.

      בחירת התפקיד של חשבון השירות לא תשפיע על הקריאות שניתן לבצע ל-Content API, כי הגישה לשיטות של Content API נקבעת לפי התפקיד שמשויך למזהה חשבון השירות ב-Merchant Center. אם אתם לא בטוחים מה לבחור, תוכלו פשוט לבחור באפשרות Project > Viewer.

   7. תועברו לדף Service Accounts, שבו תוכלו לגשת לחשבון השירות החדש.
   8. כדי לקבל מפתח פרטי מסוג JSON, לוחצים על חשבון השירות ואז על הכרטיסייה KEYS. לוחצים על ADD KEY (הוספת מפתח) > Create new key (יצירת מפתח חדש) ובוחרים באפשרות JSON בתור סוג המפתח. לוחצים על CREATE כדי להוריד את המפתח הפרטי למחשב.
2. מוסיפים את חשבון השירות החדש כמשתמש לחשבון Merchant Center. אם אתם מפתחים של צד שלישי, תצטרכו לבקש מהלקוח לבצע את השלב הזה בשבילכם.
   1. עוברים אל חשבון Merchant Center.
   2. עוברים אל גישה לחשבון בהגדרות של חשבון Merchant Center.
   3. לוחצים על + הוספת משתמש ומשתמשים במזהה של חשבון השירות ככתובת האימייל של המשתמש החדש.

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

   4. מציינים את ההעדפות של גישת משתמשים והתראות באימייל לחשבון השירות. שימו לב שהשימוש בשירות Accounts מחייב הרשאת אדמין.
   5. לוחצים על הוספת משתמש כדי לשמור את ההעדפות ולחזור לרשימת המשתמשים. מזהה חשבון השירות צריך להופיע עם תפקיד המשתמש שנבחר.
   6. חוזרים על התהליך לכל חשבונות השירות האחרים שרוצים להוסיף.
3. עכשיו תוכלו לגשת לחשבון Merchant Center באמצעות חשבון השירות, באמצעות התהליך Google Application Default Credentials או ישירות באמצעות התהליך של חשבון השירות. בדוגמאות ל-Content API for Shopping מוסבר איך להשתמש בשני התהליכים להזנת פרטי הכניסה של חשבון השירות בכל שפת תכנות נתמכת. כדאי לעיין בדוגמאות הקוד כדי לנסות את חשבון השירות החדש ולגלות אילו שינויים צריך לבצע כדי להשתמש בחשבונות שירות בקוד שלכם.

שאלות נפוצות

האם אפשר להיכנס לממשק המשתמש של Merchant Center באמצעות חשבון השירות?

לא, חשבונות שירות הם לא חשבונות Google רגילים, והם לא יכולים לגשת לממשק המשתמש של Merchant Center.

באיזו תדירות צריך לרענן את אסימוני הגישה של חשבון השירות?

התוקף של

אסימוני הגישה יפוג שעה אחת אחרי שהם יונפקו על ידי שרת ההרשאות של Google OAuth 2.0. כשפג התוקף של אסימון גישה, האפליקציה צריכה להשתמש בספריית הלקוח כדי לאחזר אסימון גישה אחר.