Method: files.create

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

상담사는 파일의 URL 또는 바이너리와 해당 썸네일 파일의 URL (선택사항)을 제공합니다.

중요: 사용자 개인 정보 보호 및 보안을 위해 RBM 플랫폼은 제공된 URL에서 미디어 및 PDF 파일을 다운로드하고 처리한 후 사용자에게 전송합니다. 이렇게 하면 고유한 URL로 상담사를 추적할 수 없습니다. 따라서 고유한 URL을 대량으로 제출하지 마세요. URL이 동일한 파일을 가리키든 다른 파일을 가리키든 RBM 플랫폼에서는 이를 지원하지 않습니다. 동일한 파일에는 동일한 URL을 사용합니다.

RBM 플랫폼은 파일을 60일 동안 캐시하고 상담사 메시지를 보낼 때 파일을 식별하는 데 사용할 수 있는 고유한 이름을 반환합니다.

파일 바이너리를 업로드하려면 업로드 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,
  "agentId": string
}
필드
fileUrl

string

선택사항입니다. 공개적으로 사용 가능한 파일 URL입니다. RBM 플랫폼은 파일을 가져올 때 HTTP 헤더의 content-type 필드에서 파일의 MIME 유형을 결정합니다. RBM은 이미지, 오디오, 동영상, PDF를 지원합니다.

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

지원되는 오디오 콘텐츠 유형: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg

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

지원되는 PDF 콘텐츠 유형: application/pdf
thumbnailUrl

string

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

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

string

필수입니다. 에이전트의 고유 식별자입니다.

응답 본문

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

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

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

string

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

승인 범위

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

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

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