Method: files.create

미디어 또는 리치 카드 메시지에 사용할 파일을 업로드합니다.

에이전트는 파일의 URL 또는 바이너리와 상응하는 썸네일 파일의 URL (선택사항)을 제공합니다. RBM 플랫폼은 30일 동안 파일을 캐시하고 에이전트 메시지를 보낼 때 파일을 식별하는 데 사용할 수 있는 고유한 이름을 반환합니다.

파일 바이너리를 업로드하려면 업로드 URI에 HTTP POST 요청을 하고, JSON 요청 본문에서 fileUrl 필드를 생략하고, 바이너리를 POST 요청 본문으로 지정합니다. 예를 들어 --upload-file cURL 플래그를 바이너리 파일의 정규화된 파일 경로와 함께 사용합니다.

HTTP 요청

  • 미디어 업로드 요청의 업로드 URI:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • 메타데이터 전용 요청용 메타데이터 URI:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "contentDescription": string,
  "agentId": string
}
필드
fileUrl

string

선택사항입니다. 공개적으로 사용 가능한 파일 URL입니다. RBM 플랫폼은 파일을 가져올 때 HTTP 헤더의 content-type 필드에서 파일의 MIME 유형을 확인합니다.

지원되는 이미지 콘텐츠 유형: image/jpeg, image/jpg, image/gif, image/png

지원되는 동영상 콘텐츠 유형: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm
thumbnailUrl

string

선택사항입니다. 파일에 해당하는 썸네일의 공개적으로 사용 가능한 URL입니다. 이 필드를 설정하지 않으면 RBM 플랫폼이 파일에서 자동으로 썸네일을 생성합니다. RBM 플랫폼은 파일을 가져올 때 HTTP 헤더의 content-type 필드에서 파일의 MIME 유형을 확인합니다.

지원되는 이미지 콘텐츠 유형: image/jpeg, image/jpg, image/gif, image/png
contentDescription

string

선택사항입니다. 파일 콘텐츠의 텍스트 설명입니다. 스크린 리더는 장애가 있는 사용자가 파일에 포함된 내용을 이해할 수 있도록 이 설명을 사용합니다.
agentId

string

필수 항목입니다. 상담사의 고유 식별자입니다.

응답 본문

에이전트가 메시지를 보낼 때 파일을 식별하는 데 사용할 수 있는 고유한 이름이 있는 파일 리소스입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "name": string
}
필드
name

string

서버에서 할당한 파일 리소스의 고유한 이름으로, 에이전트가 메시지를 보낼 때 파일을 식별하는 데 사용할 수 있습니다. 형식은 'files/{uid}'이며, 여기서 {uid}는 고유 ID입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.