Method: phones.testers.create

הזמנת משתמש לבדוק נציג.

המשתמש שהוזמן צריך להיות תומך ב-RCS ולהיות נגיש לפלטפורמת RBM. כשנציג מזמין משתמש להיות בודק, נציג של ניהול פלטפורמת RBM שולח הודעה למשתמש ומבקש ממנו לאשר שהוא רוצה להיות בודק של הנציג. אחרי שהמשתמש יאשר את הבקשה, הוא יהפוך לבודק.

נציג שעדיין לא הופעל יכול לתקשר רק עם משתמשים שהם בודקים של הנציג הזה. אם נציג שלא הופעל מנסה לשלוח קריאה חוזרת (callback) להודעה, אירוע או יכולת למשתמש שאינו בודק, פלטפורמת RBM תחזיר את השגיאה 403 PERMISSION_DENIED.

סוכן יכול לשלוח 20 בקשות בודקים ביום, עד 200 בקשות בודקים בסך הכול. אם שולחים בקשות לבודקים מעבר למגבלות האלה, פלטפורמת RBM תחזיר את התשובה 429 RESOURCE_EXHAUSTED.

בקשת HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

'phones/{E.164}', כאשר {E.164} הוא מספר הטלפון של המשתמש בפורמט E.164. לדוגמה, עם מספר הטלפון בארה"ב +1-222-333-4444, נקודת הקצה שתתקבל תהיה https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.

פרמטרים של שאילתה

פרמטרים
agentId

string

חובה. המזהה הייחודי של הנציג.

גוף הבקשה

גוף הבקשה מכיל מופע של Tester.

גוף התגובה

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

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.