new_releases עדכונים: בדקו את
נתוני הגרסה כדי לגלות תכונות חדשות ועדכוני מוצרים.
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 משתמשת בתחביר של Transcoding של 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 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eUsers can be invited to test an agent, but they must be RCS-enabled and reachable by the RBM platform, and they must also confirm their desire to be a tester.\u003c/p\u003e\n"],["\u003cp\u003eUnlaunched agents can only interact with users who have been confirmed as testers, otherwise a \u003ccode\u003e403 PERMISSION_DENIED\u003c/code\u003e error will occur.\u003c/p\u003e\n"],["\u003cp\u003eAn agent is restricted to sending only 20 tester requests per day, with a maximum of 200 tester requests total, exceeding these limits results in a \u003ccode\u003e429 RESOURCE_EXHAUSTED\u003c/code\u003e error.\u003c/p\u003e\n"],["\u003cp\u003eThe URL endpoint for sending a request to invite a tester follows the format \u003ccode\u003ePOST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers\u003c/code\u003e where the phone number of the user must be in E.164 format.\u003c/p\u003e\n"],["\u003cp\u003eAn agent's unique identifier is required in the request as the \u003ccode\u003eagentId\u003c/code\u003e query parameter.\u003c/p\u003e\n"]]],[],null,["# Method: phones.testers.create\n\nInvites a user to test an agent.\n\nThe invited user must be RCS-enabled and reachable by the RBM platform. When an agent invites a user to become a tester, an RBM platform management agent sends a message to the user asking for confirmation that she wants to be a tester of the agent. Once the user confirms, she becomes a tester.\n\nAn agent that has not yet launched can only interact with users who are testers of that agent. If an unlaunched agent attempts to send a message, event, or capability callback to a non-tester, the RBM platform returns a `403 PERMISSION_DENIED` error.\n\nAn agent can send 20 tester requests each day with a total maximum of 200 tester requests. If you send tester requests above those limits, the RBM platform returns a `429 RESOURCE_EXHAUSTED` response.\n\n### HTTP request\n\n`POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` \"phones/{E.164}\", where {E.164} is the user's phone number in E.164 format. For example, with the US phone number +1-222-333-4444, the resulting endpoint would be \u003chttps://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/\u003e. |\n\n### Query parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------|\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Request body\n\nThe request body contains an instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
