Method: files.create

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

Tác nhân hỗ trợ 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. Nền tảng RBM sẽ lưu tệp vào bộ nhớ đệm trong 30 ngày và trả về một tên riêng biệt mà bạn có thể dùng để xác định tệp khi gửi tin nhắn cho nhân viên hỗ trợ.

Để tải tệp nhị phân của tệp lên, hãy tạo một yêu cầu POST HTTP đến URI tải lên, bỏ 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, đối với 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, đối với 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,
  "contentDescription": string,
  "agentId": string
}
Các 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 loại nội dung 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.

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

string

Không bắt buộc. URL được cung cấp 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 loại nội dung 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.
contentDescription

string

Không bắt buộc. Mô tả văn bản về nội dung của tệp. Trình đọc màn hình sử dụng nội dung mô tả này để giúp người dùng bị khuyết tật hiểu nội dung của tệp.
agentId

string

Bắt buộc. Mã nhận dạng duy nhất của nhân viên hỗ trợ.

Nội dung phản hồi

Tài nguyên tệp có tên riêng biệt mà nhân viên hỗ trợ có thể 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
}
Các trường
name

string

Tên riêng biệt do máy chủ chỉ định của tài nguyên tệp. Tác nhân có thể sử dụng tên này để xác định tệp khi gửi thông báo. Đị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 Tổng quan về OAuth 2.0.