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

חשבונות שירות הם חשבונות 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 Console.
   2. בוחרים פרויקט מהתפריט הנפתח בחלק העליון של הדף. אם עדיין אין לכם פרויקט, אתם יכולים ליצור אחד על ידי לחיצה על פרויקט חדש.
   3. אם עדיין לא הפעלתם את Content API for Shopping בפרויקט הזה, חפשו אותו ברשימת ממשקי Google API והפעילו אותו.
   4. לוחצים על תפריט הניווט (☰) בפינה השמאלית העליונה, בוחרים באפשרות APIs & Services (ממשקי API ושירותים) ואז בוחרים באפשרות Credentials (פרטי כניסה).
   5. כדי להגדיר חשבון שירות, בוחרים באפשרות CREATE CREDENTIALS ואז באפשרות Service account.
      
   6. נותנים שם לחשבון השירות החדש. השם הזה משמש גם כשם המשתמש שמוגדר כברירת מחדל למזהה של חשבון השירות. שומרים את המזהה של חשבון השירות, כולל החלק שאחרי התו '@', לשימוש בהמשך. לוחצים על יצירה, מבצעים את השלבים האופציונליים למתן גישה לפרויקט ולמשתמשים, ולוחצים על סיום.

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

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

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

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

שאלות נפוצות

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

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

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

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