מהם ממשקי 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?
כדי ליצור את אפליקציית הלקוח הראשונה, צריך להשלים את התנאים המוקדמים הבאים:
- יצירת חשבון Google
- רוצים לנסות את 'פרופיל העסק ב-Google'?
- יוצרים פרויקט ב-Google API Console.
- שליחת בקשה לקבלת גישה ל-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 | מסמכי תיעוד |
|
Lodging API | מסמכי תיעוד |
|
Place Actions API | מסמכי תיעוד |
|
Notifications API | מסמכי תיעוד |
|
Verifications API | מסמכי תיעוד |
|
Q&A API | מסמכי תיעוד |
|
Business Profile Performance API | מסמכי תיעוד |
|
Media API | מסמכי תיעוד |
|
Reviews API | מסמכי תיעוד |
|
Local Posts API | מסמכי תיעוד |
|
FoodMenus API | מסמכי תיעוד |
|
איך שותפים יכולים להגדיר את מבנה החשבון שלהם כך שיהיה אפשר להשתמש ב-GBP APIs?
אם אתם שותפים של צד שלישי שמנהלים את דפי העסקים של עסקים:
- נרשמים לחשבון ארגוני ב-GBP בתור סוכנות.
- כדאי להכיר את המושגים קבוצות משתמשים וקבוצות מיקומים שרלוונטיים לעסק.
- במדריך הזה מוסבר איך מנהלים מיקומים בשם עסקים.
איך עסקים מעניקים הרשאה לשותף של 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 מדומה.