שימוש בחשבונות שירות ב-OAuth 2.0 עם Manufacturer Center API

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

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

שלבים לשימוש בחשבון שירות כדי לגשת ל-Manufacturer Center API

  1. יוצרים פרטי כניסה לחשבון שירות או ניגשים לפרטי הכניסה הציבוריים שכבר יצרתם. תצטרכו ליצור מזהה לקוח OAuth 2.0 ולקבל קובץ מפתח פרטי מסוג *.json:

    1. עוברים אל Google API Console.

    2. בוחרים פרויקט בתפריט הנפתח שבחלק העליון של הדף. אם עדיין אין לכם פרויקט, לוחצים על Create Project כדי ליצור פרויקט.

    3. אם עדיין לא הפעלתם את Manufacturer Center API לפרויקט הזה, תוכלו לחפש אותו ברשימת ממשקי ה-API של Google ולהפעיל אותו.

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

    5. כדי להגדיר חשבון שירות, בוחרים באפשרות Create credentials ובאפשרות Service account key.

    יצירת צילום מסך של פרטי הכניסה לחשבון השירות.

    1. בדף הבא בוחרים באפשרות New service account (חשבון שירות חדש) ברשימה הנפתחת.

    2. נותנים שם לחשבון השירות החדש. השם הזה משמש גם כשם המשתמש שמוגדר כברירת מחדל למזהה של חשבון השירות. חשוב לזכור את מזהה חשבון השירות כדי להשתמש בו מאוחר יותר.

    צילום מסך של השם החדש של חשבון השירות.

    1. בוחרים באפשרות JSON בתור סוג המפתח ולוחצים על יצירה.

    2. הלחצן Create ישתנה ל-Creating..., ובסיום יצירת המפתח, המפתח הפרטי יוריד באופן אוטומטי כקובץ *.json.

    1. כשתחזרו לדף Credentials, חשבון השירות החדש אמור להופיע ברשימת המפתחות של חשבונות השירות.

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

    1. נכנסים לחשבון Manufacturer Center.

    2. נכנסים לרשימת המשתמשים בהגדרות של חשבון Manufacturer Center.

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

      צילום מסך של לחצן המשתמש לחשבון השירות.

    4. ממלאים בטופס את מזהה חשבון השירות ובוחרים את תפקידי המשתמש הרצויים. צריך לבחור לפחות לפחות אחד, וכדי להשתמש בשירות Accounts צריך את התפקיד 'אדמין'.

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

    הוספת צילום מסך של דף המשתמש לחשבון שירות.

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

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

    3. בכרטיסייה 'משתמשים' אפשר להציג משתמשים קיימים בחשבון השירות. אלה יהיו המשתמשים שכתובת האימייל שלהם מסתיימת ב-'gserviceaccount.com'.

  3. עכשיו אתם יכולים לגשת לחשבון Manufacturer Center דרך חשבון השירות ב-Application Default Credentials או ישירות בתהליך העבודה של חשבון השירות. הדוגמאות של Manufacturer Center API ממחישות איך להשתמש בשני התהליכים לפרטי כניסה של חשבון שירות בכל שפת תכנות נתמכת. מומלץ לעיין בדוגמאות הקוד כדי לנסות את חשבון השירות החדש וללמוד אילו שינויים תצטרכו כדי להשתמש בחשבונות שירות בקוד שלכם.

שאלות נפוצות

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

לא, חשבונות שירות הם לא חשבונות Google רגילים, ואי אפשר לגשת אליהם דרך ממשק המשתמש של Manufacturer Center.

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

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