Google Business Messages는 2024년 7월 31일에 지원 중단됩니다.
자세히 알아보기
Method: conversations.surveys.create
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
대화에서 고객 만족도 설문조사를 만듭니다.
상담사가 24시간 이내에 동일한 대화에서 여러 설문조사를 보내면 Business Messages에서는 사용자에게 첫 번째 설문조사만 전송하려고 시도합니다.
HTTP 요청
POST https://businessmessages.googleapis.com/v1/{parent=conversations/*}/surveys
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수 항목입니다. 설문조사가 포함된 대화입니다. 'conversations/{conversationId}'로 해결합니다.
|
쿼리 매개변수
| 매개변수 |
surveyId |
string
상담사가 할당한 설문조사의 고유 식별자입니다. 설문조사에서 이전 설문조사와 동일한 surveyId를 사용하려고 하면 Business Messages에서 요청을 무시합니다.
|
요청 본문
요청 본문에는 Survey의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Survey의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/businessmessages
자세한 내용은 OAuth 2.0 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eSends customer satisfaction surveys within conversations using an HTTP POST request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eOnly the first survey initiated within a 24-hour period in a conversation will be sent to the user.\u003c/p\u003e\n"],["\u003cp\u003eEach survey requires a unique \u003ccode\u003esurveyId\u003c/code\u003e assigned by the agent to be processed, reusing IDs will result in the request being ignored.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/businessmessages\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: conversations.surveys.create\n\nCreates a customer satisfaction survey in a conversation.\n\nIf an agent sends multiple surveys in the same conversation within 24 hours, Business Messages only attempts to send the first survey to the user.\n\n### HTTP request\n\n`POST https://businessmessages.googleapis.com/v1/{parent=conversations/*}/surveys`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The conversation that contains the survey. Resolves to \"conversations/{conversationId}\". |\n\n### Query parameters\n\n| Parameters ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `surveyId` | `string` The unique identifier of the survey, assigned by the agent. If a survey attempts to use the same `surveyId` as a previous survey, Business Messages ignores the request. |\n\n### Request body\n\nThe request body contains an instance of [Survey](/business-communications/business-messages/reference/rest/v1/conversations.surveys#Survey).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Survey](/business-communications/business-messages/reference/rest/v1/conversations.surveys#Survey).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/businessmessages`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
