Method: phones.testers.create

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

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

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

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
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 Overview.