Method: files.create

Tải một tệp lên để sử dụng trong tin nhắn đa phương tiện hoặc tin nhắn dạng thẻ đa dạng.

Tác nhân cung cấp URL hoặc tệp nhị phân của tệp và (không bắt buộc) URL của tệp hình thu nhỏ tương ứng.

Lưu ý quan trọng: Để đảm bảo quyền riêng tư và tính bảo mật của người dùng, nền tảng RCS cho doanh nghiệp sẽ tải xuống và xử lý các tệp đa phương tiện và tệp PDF từ các URL được cung cấp trước khi gửi cho người dùng. Điều này ngăn chặn việc theo dõi tác nhân bằng các URL duy nhất. Do đó, đừng gửi một số lượng lớn các URL duy nhất. Nền tảng RCS cho doanh nghiệp không hỗ trợ việc này, cho dù các URL đó trỏ đến cùng một tệp hay các tệp khác nhau. Sử dụng cùng một URL cho các tệp giống hệt nhau.

Nền tảng RCS cho Doanh nghiệp lưu tệp vào bộ nhớ đệm trong 60 ngày và trả về một tên duy nhất mà bạn có thể dùng để xác định tệp khi gửi tin nhắn của nhân viên hỗ trợ.

Để tải tệp nhị phân lên, hãy thực hiện yêu cầu HTTP POST đến URI tải lên, bỏ qua trường fileUrl trong nội dung yêu cầu JSON và chỉ định tệp nhị phân làm nội dung yêu cầu POST. Ví dụ: sử dụng cờ --upload-file cURL với đường dẫn tệp đủ điều kiện của tệp nhị phân.

Yêu cầu HTTP

  • URI tải lên, cho các yêu cầu tải nội dung nghe nhìn lên:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI siêu dữ liệu, cho các yêu cầu chỉ có siêu dữ liệu:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Trường
fileUrl

string

Không bắt buộc. URL công khai của tệp. Nền tảng RCS cho doanh nghiệp xác định loại MIME của tệp từ trường content-type trong tiêu đề HTTP khi tìm nạp tệp. RCS cho doanh nghiệp hỗ trợ hình ảnh, âm thanh, video và tệp PDF.

Các loại nội dung hình ảnh được hỗ trợ: image/jpeg, image/jpg, image/gif, image/png.

Các loại nội dung âm thanh được hỗ trợ: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Các loại nội dung video được hỗ trợ: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Các loại nội dung PDF được hỗ trợ: application/pdf.

Lưu ý: Một URL tệp có thể có một lệnh chuyển hướng. Các URL tệp được chuyển hướng phải có thể truy cập công khai. URL tệp không hỗ trợ lệnh chuyển hướng trong CreateAgentMessageRequest.
thumbnailUrl

string

Không bắt buộc. URL công khai của hình thu nhỏ tương ứng với tệp. Nếu bạn không đặt trường này, thì nền tảng RCS cho doanh nghiệp sẽ tự động tạo hình thu nhỏ từ tệp. Nền tảng RCS cho doanh nghiệp xác định loại MIME của tệp từ trường content-type trong tiêu đề HTTP khi tìm nạp tệp.

Các loại nội dung hình ảnh được hỗ trợ: image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của nhân viên.

Nội dung phản hồi

Một tài nguyên tệp có tên riêng biệt mà một tác nhân có thể dùng để xác định tệp khi gửi tin nhắn.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "name": string
}
Trường
name

string

Tên riêng biệt do máy chủ chỉ định cho tài nguyên tệp mà các tác nhân có thể dùng để xác định tệp khi gửi tin nhắn. Định dạng là "files/{uid}", trong đó {uid} là một mã nhận dạng duy nhất.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.