Method: files.create

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

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.

Quan trọng: Để đảm bảo quyền riêng tư và sự an toàn của người dùng, nền tảng RBM sẽ tải xuống và xử lý các tệp phương tiện và tệp PDF từ URL được cung cấp trước khi phân phối các tệp đó cho người dùng. Điều này ngăn việc theo dõi đại lý theo URL duy nhất. Do đó, đừng gửi quá nhiều URL duy nhất. Nền tảng RBM 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 RBM 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 thông báo của tác nhân.

Để tải tệp nhị phân lên, hãy tạo một yêu cầu HTTP POST đến URI Tải lên, bỏ qua trường fileUrl khỏi 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ờ cURL --upload-file 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, dành 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, dành cho các yêu cầu chỉ 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 có 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 RBM 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. RBM 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 ý: URL tệp có thể có 1 lệnh chuyển hướng. URL của tệp được chuyển hướng phải có thể truy cập công khai. Không hỗ trợ chuyển hướng cho URL tệp 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 RBM sẽ tự động tạo hình thu nhỏ từ tệp. Nền tảng RBM 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 duy nhất của tác nhân.

Nội dung phản hồi

Tài nguyên tệp có tên riêng biệt mà tác nhân có thể sử dụng để xác định tệp khi gửi thông báo.

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 của tài nguyên tệp mà tác nhân có thể sử dụng để xác định tệp khi gửi thông báo. Định dạng là "files/{uid}", trong đó {uid} là 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.