חשבונות שירות הם חשבונות Google מיוחדים שבהם אפליקציות יכולות להשתמש כדי לגשת אל Google APIs באופן פרוגרמטי דרך OAuth 2.0. חשבון שירות משתמש בתהליך OAuth 2.0 שלא מחייב הרשאה אנושית. במקום זאת, הוא משתמש בקובץ מפתח שרק לאפליקציה שלך יש גישה אליו. המדריך הזה מסביר איך לגשת ל-Content API for Shopping באמצעות חשבונות שירות.
הערה: אפליקציות שמשתמשות בחשבונות שירות לאימות יכולות לגשת רק לחשבון Merchant Center שלכם. אם אתם כותבים אפליקציה של צד שלישי שזקוקה לגישה לחשבונות Merchant Center של הלקוחות שלכם, תוכלו להיעזר במדריך בקשות לאישור.
דרישות מוקדמות
- חשבון Merchant Center.
איך משתמשים בחשבון שירות כדי לגשת ל-Content API for Shopping
- תוכלו ליצור פרטי כניסה לחשבון השירות או לגשת לפרטי הכניסה הציבוריים שכבר הפקתם. עליכם ליצור מזהה לקוח ב-OAuth 2.0 ולקבל קובץ מפתח פרטי מסוג .json:
- נכנסים למסוף Google API.
- בוחרים פרויקט בתפריט הנפתח שבחלק העליון של הדף. אם עדיין אין לכם פרויקט, לוחצים על פרויקט חדש.
- אם לא הפעלתם כבר את ה-Content API for Shopping בפרויקט הזה, חפשו אותו ברשימת ממשקי ה-API של Google והפעילו אותו.
- בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה. יכול להיות שתצטרכו ללחוץ על החץ שמצביע שמאלה למעלה כדי לראות את זה.
- כדי להגדיר חשבון שירות, בוחרים באפשרות CREATE CREDENTIALS ואז באפשרות Service account.
- נותנים שם לחשבון השירות החדש. הוא משמש גם כשם המשתמש המוגדר כברירת מחדל עבור המזהה של חשבון השירות. מומלץ לרשום את המספר של חשבון השירות, כולל החלק שאחרי התו '@' לשימוש בעתיד. לוחצים על CREATE, מבצעים את השלבים האופציונליים של הענקת גישה לפרויקט ולמשתמשים, ולוחצים על Done.
לבחירת התפקיד בחשבון השירות לא תהיה כל השפעה על הקריאות ל-Content API, כי הגישה לשיטות של Content API נקבעת לפי התפקיד שמשויך למספר של חשבון השירות ב-Merchant Center. אם אתם לא בטוחים במה לבחור, פשוט בחרו באפשרות Project > Viewer.
- המערכת תעביר אתכם לדף 'חשבונות שירות' שבו תוכלו לגשת לחשבון השירות החדש.
- כדי לקבל מפתח JSON פרטי, לוחצים על חשבון השירות ואז על הכרטיסייה KEYS. לוחצים על ADD KEY > Create new key ובוחרים באפשרות JSON בתור סוג המפתח. לוחצים על CREATE כדי להוריד את המפתח הפרטי למחשב.
- מוסיפים את חשבון השירות החדש כמשתמש לחשבון Merchant Center. אם אתם מפתחים מצד שלישי, הלקוח שלכם יצטרך לבצע את השלב הזה עבורכם.
- נכנסים לחשבון Merchant Center.
- עוברים אל גישה לחשבון בהגדרות החשבון ב-Merchant Center.
- לוחצים על + הוספת משתמש ומשתמשים במספר של חשבון השירות ככתובת האימייל של המשתמש החדש.
אם לא רשמתם את המזהה של חשבון השירות קודם, נכנסים לדף הניהול של Service accounts ובוחרים את הפרויקט שיצרתם.
- מציינים את ההעדפות של גישת משתמשים והתראות באימייל בחשבון השירות. חשוב לשים לב שהשימוש בשירות
Accounts
מחייב גישת אדמין. - לוחצים על Add user כדי להוסיף העדפות ולחזור לרשימת המשתמשים. מספר חשבון השירות צריך להיות רשום בתפקיד של המשתמש שנבחר.
- חוזרים על התהליך בכל חשבונות השירות האחרים שרוצים להוסיף.
- עכשיו אפשר לגשת לחשבון Merchant Center באמצעות חשבון השירות באמצעות התהליך של פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google, או באמצעות התהליך הישיר של חשבון השירות. דוגמאות של Content API for Shopping מראות איך להשתמש בשני התהליכים של פרטי כניסה לחשבון שירות בכל שפת תכנות נתמכת. כדאי לבדוק את דוגמאות הקוד כדי לנסות להשתמש בחשבון השירות החדש ולראות אילו שינויים תצטרכו להשתמש בחשבונות שירות בקוד שלכם.
שאלות נפוצות
- האם אפשר להיכנס לממשק המשתמש של Merchant Center באמצעות חשבון השירות שלי?
- לא, חשבונות שירות הם לא חשבונות Google רגילים ולא יכולים לגשת לממשק המשתמש של Merchant Center.
- באיזו תדירות צריך לרענן אסימוני גישה לחשבון שירות?
- תוקף אסימוני הגישה פג שעה אחת אחרי שהם מונפקים על ידי שרת ההרשאות של Google OAuth 2.0. כשתוקף אסימון הגישה פג, האפליקציה צריכה להשתמש בספריית הלקוח כדי לאחזר אסימון גישה אחר.