הגדרת אימות ל-Merchant API

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

המאמר הזה הוא חלק מסדרה של מאמרים בנושא תחילת העבודה עם Merchant API. אם כבר הגדרתם אימות ב-Merchant API, אתם יכולים לדלג לקטע הבא: הרשמה כמפתח .

אישור בקשות ל-Merchant API

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

האם אתם מפתחים אפליקציה לשימוש של עסקים אחרים?

אם כן, אתם משתמשים בהרשאת OAuth 2.0. כדאי לבחור בהרשאת OAuth 2.0 אם:

  • אתם סוכנות או ספק צד שלישי: אתם מפתחים אפליקציה, כמו פלטפורמת SaaS, שעסקים אחרים ישתמשו בה כדי לנהל את הנתונים שלהם ב-Merchant Center.
  • אתם צריכים לנהל הרבה חשבונות חיצוניים: אתם רוצים שאפליקציה אחת תפעל בכמה חשבונות Merchant Center נפרדים שבבעלות לקוחות שונים. הלקוחות נותנים הרשאות על ידי כניסה לחשבונות Google שלהם ולחיצה על "אישור" במסך הסכמה.

האם אתם מפתחים אפליקציה לעסק שלכם?

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

  • אתם מפתחים אפליקציה פנימית משלכם: אתם מפתחים כלי ספציפי לעסק שלכם כדי לנהל את הנתונים שלכם ב-Merchant Center, או שאתם רוצים שפרטי הכניסה יהיו שייכים לאפליקציה עצמה ולא למשתמש ספציפי.
  • אתם צריכים אוטומציה בלי התחברות אנושית: האפליקציה שלכם מריצה משימות ברקע, כמו עדכוני מלאי אוטומטיים או משימות cron.

הרשאה באמצעות OAuth 2.0

אם אתם סוכנות או ספק צד שלישי שמנהלים כמה חשבונות של לקוחות, האפליקציה שלכם חייבת להשתמש ב-OAuth 2.0 כדי לאשר בקשות. כדי להגדיר את OAuth 2.0 ל-Merchant API:

  1. יוצרים פרטי כניסה מסוג OAuth 2.0 בקטע ממשקי API ושירותים במסוף Google Cloud.
  2. מורידים את פרטי הכניסה של לקוח OAuth2 לקובץ, למשל client-secrets.json
  3. הוספת חשבון האימייל כמשתמש ב-Merchant Center: ודאו שחשבון Google שבו אתם משתמשים כדי לאשר בקשות קיים כמשתמש ב-Merchant Center. פרטים נוספים זמינים במאמר איך מוסיפים או מסירים משתמשים ב-Merchant Center.
  4. מקצים לו את התפקיד Admin כדי לבצע רישום. מידע נוסף על תפקידים זמין במאמר ניהול משתמשים ורמות גישה ב-Merchant Center.
  5. הגדרת אימות באמצעות דוגמאות קוד: פועלים לפי ההנחיות בקטע הגדרת אימות והגדרות לדוגמה בדוגמאות הקוד הרשמיות.

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

הרשאה באמצעות חשבון שירות

אתם משתמשים בחשבון שירות כדי לאשר גישה של Merchant API לחשבון Merchant Center שלכם. כדי להגדיר הרשאה לחשבון שירות ב-Merchant API:

  1. יוצרים פרטי כניסה לחשבון שירות בקטע APIs and Services במסוף Google Cloud.
  2. הורדת המפתח הפרטי: יוצרים ומורידים את המפתח הפרטי בפורמט JSON לחשבון השירות. משנים את שם הקובץ ל-service-account.json
  3. הוספת חשבון השירות ל-Merchant Center: מעתיקים את כתובת האימייל הייחודית של חשבון השירות, למשל sa@project.iam.gserviceaccount.com, ומוסיפים אותה כמשתמש חדש ב-Merchant Center. פרטים נוספים זמינים במאמר איך להוסיף או להסיר משתמשים מ-Merchant Center.
  4. מקצים לו גישה מסוג Admin. מידע נוסף על רמות גישה זמין במאמר ניהול משתמשים ורמות גישה ב-Merchant Center.
  5. הגדרת אימות באמצעות דוגמאות קוד: פועלים לפי ההנחיות בדוגמאות הקוד הרשמיות בקטע הגדרת אימות ותיעוד של הגדרות לדוגמה.

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