שאלות נפוצות

מהם ממשקי GBP API?

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

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

למי יש גישה לממשקי ה-API של GBP?

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

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

האם גישה לממשקי ה-API של GBP מאפשרת למשתמש לשלוח שאילתה לגבי נתונים כלשהם של 'פרופיל העסק ב-Google'?

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

מהן כללי המדיניות הרלוונטיים למשתמשי GBP API?

השותפים צריכים לפעול בהתאם למדיניות של 'פרופיל העסק ב-Google', וכן לכל כללי המדיניות והתנאים וההגבלות של ה-API.

איך משתמשים מקבלים גישה ל-GBP API?

כדי ליצור את אפליקציית הלקוח הראשונה, צריך להשלים את התנאים המוקדמים הבאים:

  1. יצירת חשבון Google
  2. רוצים לנסות את 'פרופיל העסק ב-Google'?
  3. יוצרים פרויקט ב-Google API Console.
  4. שליחת בקשה לקבלת גישה ל-API: הבקשות נבדקות תוך 14 ימים.

איך משתמשים מקבלים גישה ל-API מסוים ב-GBP API?

יש שמונה ממשקי API שמשויכים לפרופיל העסק, וצריך להפעיל אותם במסוף Google API:

  • Google My Business API 4.9, שכולל את קריאות ה-API החשובות הבאות של התכונות:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • My Business Business Information API
  • My Business Q&A API
  • Business Profile Performance API

אם הבקשה של משתמש לקבלת גישה תאושר, הוא יקבל מכסת ברירת מחדל רגילה לכל שמונה ממשקי ה-API.

איך פועלת הגישה ל-GBP API?

הגישה ל-GBP API ניתנת ברמת הפרויקט ב-Google Cloud. אם משתמש א' הגיש בקשה לגישה ל-Google Business Profile API לפרויקט מס' 12345678, תהיה לו גישה לפרויקט מס' 12345678. לכן, כל משתמש, כולל משתמש א' עם גישה לפרויקט ב-Google Cloud, יכול לבצע קריאות לממשקי ה-API של פרופיל העסק ב-Google. כדי למנוע שימוש לרעה, השותפים צריכים לשלוט בגישה לפרויקט ב-Google Cloud על בסיס צורך.

יש לך סיכום של ממשקי ה-API ודוגמאות ליכולות?

בטבלה הבאה מפורט מידע על ממשקי ה-API השונים ועל היכולות שלהם.

API מסמכי עזרה דוגמאות ליכולות
Account Management API מסמכי תיעוד
  • ניהול הגישה למיקום.
  • יצירת חשבון עם השם והסוג שצוינו, מתחת לחשבון ההורה הנתון.
  • רשימה של כל החשבונות של המשתמש המאומת.
  • הצגת רשימת ההזמנות שממתינות להחלטה בחשבון שצוין.
  • העברת מיקום מחשבון שבבעלות המשתמש לחשבון אחר.
  • עדכון האדמין של המיקום שצוין.
Business Information API מסמכי תיעוד
  • באמצעות Business Information API אפשר לנהל את מחזור החיים של הפרופיל ולהוסיף או לנהל את פרטי העסק ב-GBP.
  • מאפשרת למוכרים לקבל, ליצור, לעדכן או למחוק פרופילים של עסקים ב-Google.
  • מאפשרת למוכרים לקבל או לעדכן מאפייני פרופיל.
  • מאפשרת למוכרים לקבל או לחפש רשתות וקטגוריות של פרופילים.
Lodging API מסמכי תיעוד
  • מאפשרת לנהל נתונים של חדרי אירוח, למשל, שירותים בנכס, ומדיניות לעסקים ב-Google. ה-API מיועד לעסקים שמספקים שירותי לינה, כמו מלונות. Lodging API מאפשר למפתחים לעדכן את מאפייני האירוח בפרופיל העסק ב-Google.
Place Actions API מסמכי תיעוד
  • מאפשרת לנהל קישורים לפעולות לגבי עסקים.
  • להפנות משתמשים לבצע פעולות כמו קביעת פגישה, הזמנה של שולחן והזמנת משלוח אוכל.
Notifications API מסמכי תיעוד
  • מאפשרת לנהל את הגדרות ההתראות בחשבונות מסוימים.
Verifications API מסמכי תיעוד
  • התחלת תהליך האימות של מיקום.
  • הדוח כולל את כל אפשרויות האימות שעומדות בדרישות עבור מיקום מסוים בשפה ספציפית.
Q&A API מסמכי תיעוד
  • מאפשר לנהל את השאלות והתשובות של מיקום מסוים.
Business Profile Performance API מסמכי תיעוד
  • מאפשרת למוכרים לאחזר תובנות לגבי ביצועי דף העסק שלהם ב-Google.
  • התובנות כוללות חשיפות של העסק, בקשות לקבלת מסלול, קליקים לשיחה, קליקים באתר, הזמנות, הזמנות אוכל, אינטראקציות בתפריט ועוד.
Media API מסמכי תיעוד
  • מאפשר למפתחי ממשקי API להעלות תמונות וסרטונים לפרופיל העסק.
Reviews API מסמכי תיעוד
  • מאפשרת למוכרים לקבל ביקורות ולהשיב לביקורות בפרופיל העסק.
Local Posts API מסמכי תיעוד
  • מאפשרת למוכרים לקבל, ליצור או לעדכן פוסטים מקומיים.
FoodMenus API מסמכי תיעוד
  • מאפשרת למוכרים לקבל, ליצור או לעדכן תפריטי מזון בפרופיל העסק.

איך שותפים יכולים להגדיר את מבנה החשבון שלהם כך שיהיה אפשר להשתמש ב-GBP APIs?

אם אתם שותפים של צד שלישי שמנהלים את דפי העסקים של עסקים:

איך עסקים מעניקים הרשאה לשותף של GBP API לנהל את דף העסק שלהם?

עסקים מעניקים גישה לשותף צד שלישי בשתי דרכים:

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

    הערה: מומלץ מאוד לשותפים של צד שלישי לא להוסיף את עצמם כבעלים של חשבון ה-GBP, אלא רק כמנהלים.

אם לעסק יש יותר מ-10 מיקומים, האם יש דרך לבצע אימות בכמות גדולה?

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

מהן מגבלות המכסות של ממשקי ה-API השונים?

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

איזו מכסה אפשר לבקש?

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

האם שותפי GBP API יכולים ליצור חשבון בדיקה ל-prod?

לא. לצערנו, אין דרך ישירה ליצור כרטיס מוצר מזויף ב-GBP בסביבת הייצור, דרך ממשק המשתמש או ה-API של GBP, ולבדוק אותו.

רוב כרטיסי המוצר המזויפים שנוצרים מסומנים על ידי צוות התמיכה שלנו ומבוטלים. מומלץ להשתמש בדף עסק של לקוח ולעבוד איתו מחוץ לשעות הפעילות (בתנאי שלא משנים את המידע הראשי בדף העסק, כמו שם, כתובת, קטגוריה), או ליצור דף עסק למטה החברה. אם אתם רוצים לבדוק תגובה של API כדי לאמת כרטיס מוצר או כל פעולה אחרת שדורשת כרטיס מוצר בסביבת הייצור, תוכלו להשתמש בתגובות API מדומה.