Method: files.create

Przesyła plik do wykorzystania w wiadomościach z multimediami lub kartach z elementami multimedialnymi.

Agent podaje adres URL lub dane binarne pliku oraz (opcjonalnie) adres URL odpowiedniego pliku miniatury.

Ważne: ze względu na prywatność i bezpieczeństwo użytkowników platforma RCS dla firm pobiera i przetwarza pliki multimedialne oraz PDF z podanych adresów URL, zanim dostarczy je użytkownikowi. Zapobiega to śledzeniu agenta za pomocą unikalnych adresów URL. Nie przesyłaj więc dużej liczby unikalnych adresów URL. Platforma RCS dla firm nie obsługuje tego, niezależnie od tego, czy adresy URL wskazują ten sam czy różne pliki. Używaj tego samego adresu URL w przypadku identycznych plików.

Platforma RCS dla firm buforuje plik przez 60 dni i zwraca unikalną nazwę, której możesz użyć do identyfikacji pliku podczas wysyłania wiadomości agenta.

Aby przesłać plik binarny, wyślij żądanie HTTP POST na adres URL przesyłania, pomiń pole fileUrl w treści żądania JSON i określ plik binarny jako treść żądania POST. Użyj na przykład flagi --upload-file polecenia cURL z pełną ścieżką do pliku binarnego.

Żądanie HTTP

  • Identyfikator URI przesyłania w przypadku żądań przesyłania multimediów:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Pola
fileUrl

string

Opcjonalnie: Publicznie dostępny adres URL pliku. Platforma RCS dla firm określa typ MIME pliku na podstawie pola content-type w nagłówkach HTTP podczas pobierania pliku. RCS dla firm obsługuje obrazy, dźwięk, wideo i PDF.

Obsługiwane typy treści obrazów: image/jpeg, image/jpg, image/gif, image/png.

Obsługiwane typy treści audio: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Obsługiwane typy treści wideo: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Obsługiwane typy treści PDF: application/pdf.

Uwaga: URL pliku może mieć jedno przekierowanie. Adresy URL przekierowanych plików muszą być dostępne publicznie. Adresy URL plików w przypadku żądania CreateAgentMessageRequest nie obsługują przekierowań.
thumbnailUrl

string

Opcjonalnie: Publicznie dostępny adres URL miniatury odpowiadającej plikowi. Jeśli to pole nie jest ustawione, platforma RCS dla firm automatycznie generuje miniaturę z pliku. Platforma RCS dla firm określa typ MIME pliku na podstawie pola content-type w nagłówkach HTTP podczas pobierania pliku.

Obsługiwane typy treści obrazów: image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Wymagane. Unikalny identyfikator agenta.

Treść odpowiedzi

Zasób pliku z unikalną nazwą, której agent może używać do identyfikowania pliku podczas wysyłania wiadomości.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "name": string
}
Pola
name

string

Unikalna nazwa pliku przypisana przez serwer, której agenci mogą używać do identyfikowania pliku podczas wysyłania wiadomości. Format to „files/{uid}”, gdzie {uid} to unikalny identyfikator.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.