שאלות נפוצות

מהם ממשקי API של GBP?

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

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

מי יכול לקבל גישה לממשקי ה-API של GBP?

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

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

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

לא. גם אם קיבלתם גישה לממשקי API של GBP, אי אפשר להריץ שאילתות על נתונים מפרופיל העסק ב-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
  • ממשק API לניהול חשבון העסק שלי
  • ממשק API של My Business Lodging
  • API ל-My Business Place Actions
  • My Business Notifications API
  • API לאימות העסק שלי
  • API של פרטי העסק שלי
  • ממשק 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 מסמכי תיעוד
  • מאפשר ניהול של קישורים לפעולות לגבי מקומות בעסקים.
  • מפנה משתמשים לפעולות כמו קביעת תור או פגישה, הזמנת שולחן והזמנת משלוחי אוכל.
Notification API מסמכי תיעוד
  • מאפשר ניהול של הגדרות התראות עבור חשבונות מסוימים.
Authentications API מסמכי תיעוד
  • התחלת תהליך האימות של מיקום.
  • מדווח על כל אפשרויות האימות הכשירות של מיקום בשפה מסוימת.
API של שאלות ותשובות מסמכי תיעוד
  • ההרשאה הזו מאפשרת לנהל את השאלות והתשובות לגבי מיקום.
Business Profile Performance API מסמכי תיעוד
  • התכונה מאפשרת למוכרים לקבל תובנות לגבי הביצועים של הדף העסקי שלהם ב-Google.
  • התובנות כוללות חשיפות של העסק, בקשות לקבלת מסלול הגעה, קליקים לשיחה, קליקים שמפנים לאתר, הזמנות, הזמנות אוכל, אינטראקציות בתפריט ועוד.
Media API מסמכי תיעוד
  • מאפשר למפתחי API להעלות תמונות וסרטונים לפרופיל עסק.
Reviews API מסמכי תיעוד
  • המוכרים יכולים לקבל ביקורות ולהשיב לביקורות בפרופיל העסק.
Local פוסטים API מסמכי תיעוד
  • התכונה מאפשרת למוכרים לקבל, ליצור או לעדכן פוסטים מקומיים.
Foodתפריטs API מסמכי תיעוד
  • מוכרים יכולים לקבל, ליצור או לעדכן תפריטי אוכל לפרופיל עסק.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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