Method: phones.testers.create

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

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

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

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

הוצאה משימוש: השיטה הזו תוצא משימוש ב-31 בינואר 2026. מידע נוסף זמין במאמר בנושא השיטה החדשה לבדיקת תכונות ב-Business Communications API.

בקשת 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.