סקירה כללית

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

הסברים על המונחים

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

• אימות: בתהליך הזה, השירות מאמת את הזהות של המשתמש או האפליקציה ששולחים בקשת API. ‫Merchant API משתמש במנגנונים סטנדרטיים של Google כמו OAuth 2.0. אי אפשר להשתמש במפתחות API לאימות, ואם תנסו לעשות את זה תקבלו שגיאות אימות. למידע נוסף, קראו את המאמרים אימות בקשות ואימות באמצעות החשבון שלכם.
• הרשאה: התהליך הזה קובע אילו פעולות המשתמש או האפליקציה המאומתים יכולים לבצע באמצעות חשבון Merchant Center. הוא עונה על השאלה: "מה אפשר לעשות?" על סמך התפקידים וההרשאות שניתנו למשתמש המאומת בחשבון Merchant Center. לדוגמה, יכול להיות שלמשתמש תהיה הרשאה לקרוא נתוני מוצרים, אבל לא לשנות את הגדרות החשבון.
• הרשמה: תהליך הגדרה חד-פעמי שמאפשר ל-Google לשלוח לכם הודעות חשובות בנוגע לשירות בחשבונות המוכרים שאתם מנהלים. במהלך הרישום, כתובות האימייל של המפתחים מתווספות לחשבון הראשי ב-Merchant Center, והחשבון מקושר למזהי הפרויקטים בענן ב-Google Cloud שמשמשים לאימות. הקישור הזה מאפשר לאפליקציה לקבל הודעות בנוגע לשירות עבור כל חשבונות של מוכרים שאתם מנהלים. מידע נוסף זמין במאמר יצירת פרויקט ב-Google Cloud.

הרשמה

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

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

כדי להירשם לשימוש ב-Merchant API, צריך:

• חשבון Merchant Center: צריך חשבון Merchant Center קיים.
• הרשאת אדמין: לחשבון המשתמש ב-Google שבו אתם משתמשים כדי להתחיל את קריאת הרישום צריכות להיות הרשאות אדמין בחשבון Merchant Center שאתם רושמים.
• פרויקט ב-Google Cloud: האפליקציה צריכה להיות משויכת לפרויקט ב-Google Cloud. הפרויקט הזה מספק את פרטי הכניסה הנדרשים (כמו מזהי לקוח ב-OAuth 2.0) כדי לאמת את האפליקציה.

למה אי אפשר לרשום פרויקט בענן משותף ב-Google Cloud

כלים כמו Google OAuth Playground ו-APIs Explorer משתמשים בפרויקטים משותפים ב-Google Cloud שבבעלות Google. אי אפשר להירשם עם פרויקטים משותפים כי:

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

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

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

איך מוצאים את מזהה הפרויקט ב-Google Cloud

אפשר למצוא את מזהה הפרויקט ואת מספר הפרויקט במסוף Google Cloud. למידע נוסף, קראו את המאמר איתור השם, המספר והמזהה של הפרויקט.

טיפ: מזהה הפרויקט הוא מחרוזת ייחודית, ומספר הפרויקט הוא מספר שלם ייחודי. בתהליך הרישום בדרך כלל משתמשים במספר הפרויקט.

ביצוע שיחת הרישום

נרשמים באמצעות ה-method‏ registerGcp ב-API המשני Accounts. הקריאה הזו משייכת את מספר הפרויקט ב-Google Cloud לחשבון Merchant Center.

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

מידע על שדה האימייל

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

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

המשאב users לניהול אנשי קשר

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

כדי להשתמש בתכונות האלה:

1. הוספת כל המפתחים: הוסיפו את המפתחים שעובדים על שילוב ה-API כמשתמשים בחשבון Merchant Center.
2. הקצאת התפקיד API_DEVELOPER: בנוסף לתפקידים הרגילים (אדמין, רגיל), אתם יכולים להקצות למשתמשים את התפקיד API_DEVELOPER. באופן ספציפי, כדאי להקצות את התפקיד הזה למשתמשים שצריכים לקבל הודעות שקשורות ל-API. אפשר לשלב אותו עם תפקידים אחרים.
3. יתרונות:
   • הפרדה ברורה: ניהול אנשי הקשר בנושאי API מופרד מההרשמה החד-פעמית.
   • גמישות: אפשר לעדכן את אנשי הקשר כשהצוות משתנה.
   • תקשורת ממוקדת: כדי לוודא שחדשות ספציפיות ל-API מגיעות לאנשים הרלוונטיים.

גם אם סיפקתם כתובת אימייל במהלך ההרשמה, מומלץ מאוד לנהל את אנשי הקשר של ה-API על ידי הוספת משתמשים עם התפקיד API_DEVELOPER.

קובצי עזר

למידע נוסף, קראו את המאמרים הבאים:

• מדריך למתחילים
• DeveloperRegistration methods