מתן הרשאת גישה לחשבון Merchant Center

חובה לבצע אימות כדי להשתמש ב-Merchant API. אפשר לבצע אימות באמצעות פרטי כניסה של OAuth 2.0, חשבון שירות או Application Default Credentials ‏ (ADC) (בדרך כלל משמש לבדיקות ולפיתוח מקומי).

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

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

כדי לבצע את השלבים האלה, צריך שיהיה לכם חשבון Merchant Center.

שימו לב: מפתחות API לא נתמכים על ידי Merchant API. ניסיון להשתמש במפתח API כדי לאשר בקשות יגרום לשגיאה 401 UNAUTHENTICATEDCREDENTIALS_MISSING.

יצירה של חשבון שירות

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

1. עוברים אל Google API Console.
2. בוחרים פרויקט בתפריט הנפתח בראש הדף או לוחצים על פרויקט חדש כדי ליצור פרויקט.
3. מחפשים את Merchant API ברשימת ממשקי Google API ומוודאים שהוא מופעל בפרויקט הזה.
4. לוחצים על ניהול.
5. בסרגל הצד שמימין, בוחרים באפשרות פרטי כניסה. יכול להיות שתצטרכו ללחוץ על החץ שפונה ימינה בפינה הימנית העליונה של הדף כדי לראות את האישורים.
6. לוחצים על CREATE CREDENTIALS (יצירת אמצעי אימות) ואז על Service account (חשבון שירות).
7. נותנים שם לחשבון השירות. זהו שם המשתמש שמוגדר כברירת מחדל למזהה של חשבון השירות. שומרים את המזהה של חשבון השירות, כולל החלק שאחרי התו '@', לשימוש בהמשך.

8. לוחצים על CREATE, מבצעים את השלבים האופציונליים למתן גישה לפרויקט ולמשתמשים, ואז לוחצים על DONE.

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

קבלת מפתח פרטי מסוג JSON

יוצרים מפתח JSON פרטי לחשבון השירות ב-Google API Console:

1. לוחצים על חשבון השירות ובוחרים בכרטיסייה KEYS.
2. לוחצים על ADD KEY > Create new key (הוספת מפתח > יצירת מפתח חדש).
3. בוחרים באפשרות JSON בתור סוג המפתח.
4. לוחצים על יצירה כדי להוריד את המפתח הפרטי. הערה: אפשר להוריד את המפתח הפרטי רק בזמן שהוא נוצר. אי אפשר לחזור לשלב הזה מאוחר יותר.

מתן גישה לחשבון שירות לחשבון Merchant Center

מוסיפים את חשבון השירות החדש כמשתמש לחשבון Merchant Center:

1. נכנסים לחשבון Merchant Center.
2. לוחצים על הגדרות הגדרות.
3. בתפריט הנפתח, לוחצים על גישה ושירותים.
4. בכרטיסייה 'משתמשים והרשאות גישה', לוחצים על הוספת משתמש.

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

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

6. מציינים את ההעדפות של User access ושל Email notifications עבור חשבון השירות.

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

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

אפשר לחזור על השלבים האלה לכל חשבונות השירות שצריכים לגשת לנתונים בחשבון Merchant Center.

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

שאלות נפוצות

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

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

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

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