Method: files.create

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

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

중요: 사용자 개인 정보 보호 및 보안을 위해 비즈니스용 RCS 플랫폼은 제공된 URL에서 미디어 및 PDF 파일을 다운로드하여 처리한 후 사용자에게 전송합니다. 이렇게 하면 고유 URL에 의한 에이전트 추적이 방지됩니다. 따라서 많은 수의 고유 URL을 제출하지 마세요. URL이 동일한 파일을 가리키든 다른 파일을 가리키든 비즈니스용 RCS 플랫폼에서는 이를 지원하지 않습니다. 동일한 파일에 동일한 URL을 사용합니다.

비즈니스용 RCS 플랫폼은 파일을 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입니다. 비즈니스용 RCS 플랫폼은 파일을 가져올 때 HTTP 헤더의 content-type 필드에서 파일의 MIME 유형을 확인합니다. 비즈니스용 RCS는 이미지, 오디오, 동영상, 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

참고: 파일 URL에는 리디렉션이 하나 있을 수 있습니다. 리디렉션된 파일 URL은 공개적으로 액세스할 수 있어야 합니다. CreateAgentMessageRequest의 파일 URL에는 리디렉션이 지원되지 않습니다.
thumbnailUrl

string

선택사항입니다. 파일에 해당하는 썸네일의 공개적으로 사용 가능한 URL입니다. 이 필드를 설정하지 않으면 비즈니스용 RCS 플랫폼에서 파일로부터 썸네일을 자동으로 생성합니다. 비즈니스용 RCS 플랫폼은 파일을 가져올 때 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를 참조하세요.