מתן הרשאת גישה לחשבון 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 UNAUTHENTICATED CREDENTIALS_MISSING.

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

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

1. נכנסים אל Google API Console.
2. בוחרים פרויקט בתפריט הנפתח שבחלק העליון של הדף, או לוחצים על NEW PROJECT כדי ליצור פרויקט חדש.
3. מחפשים את Merchant API ברשימת Google APIs ומוודאים שהוא מופעל בפרויקט הזה.
4. לוחצים על ניהול.
5. בסרגל הצד שמימין, לוחצים על Credentials. יכול להיות שתצטרכו ללחוץ על החץ שפונה שמאלה בפינה הימנית העליונה של הדף כדי לראות את Credentials.
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. לוחצים על CREATE כדי להוריד את המפתח הפרטי. הערה: אפשר להוריד את המפתח הפרטי רק כשיוצרים אותו. לא תוכלו לחזור לשלב הזה מאוחר יותר.

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

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

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

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

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

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

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

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

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

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

שאלות נפוצות

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

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

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

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