Method: files.create

Medya veya zengin kart mesajlarında kullanılacak bir dosyayı yükler.

Aracı, dosyanın URL'sini veya ikili dosyasını ve (isteğe bağlı olarak) ilgili küçük resim dosyasının URL'sini sağlar.

Önemli: İşletmeler için RCS platformu, kullanıcı gizliliği ve güvenliği açısından, sağlanan URL'lerdeki medya ve PDF dosyalarını kullanıcıya iletmeden önce indirip işler. Bu durum, benzersiz URL'lerle temsilci izlemeyi engeller. Bu nedenle, yüksek hacimli benzersiz URL göndermeyin. URL'ler aynı veya farklı dosyalara yönlendiriyor olsa da İş için RCS platformu bunu desteklemez. Aynı dosyalar için aynı URL'yi kullanın.

İşletmeler için RCS platformu, dosyayı 60 gün boyunca önbelleğe alır ve temsilci mesajları gönderirken dosyayı tanımlamak için kullanabileceğiniz benzersiz bir ad döndürür.

İkili dosya yüklemek için yükleme URI'sine bir HTTP POST isteği gönderin, JSON istek gövdesinden fileUrl alanını çıkarın ve ikili dosyayı POST istek gövdesi olarak belirtin. Örneğin, ikili dosyanın tam olarak belirtilmiş dosya yoluyla birlikte --upload-file cURL işaretini kullanın.

HTTP isteği

  • Medya yükleme istekleri için yükleme URI'si:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • Yalnızca meta veri istekleri için meta veri URI'si:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Alanlar
fileUrl

string

İsteğe bağlıdır. Dosyanın herkese açık URL'si. İşletmeler için RCS platformu, dosyayı getirirken HTTP üstbilgilerindeki içerik türü alanından dosyanın MIME türünü belirler. İşletmeler için RCS; resim, ses, video ve PDF'yi destekler.

Desteklenen resim içerik türleri: image/jpeg, image/jpg, image/gif, image/png.

Desteklenen ses içeriği türleri: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Desteklenen video içerik türleri: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Desteklenen PDF içerik türleri: application/pdf.

Not: Bir dosya URL'si tek bir yönlendirmeye sahip olabilir. Yönlendirilen dosya URL'lerine herkesin erişebilmesi gerekir. CreateAgentMessageRequest'teki dosya URL'leri için yönlendirmeler desteklenmez.
thumbnailUrl

string

İsteğe bağlıdır. Dosyaya karşılık gelen küçük resmin herkese açık URL'si. Bu alan ayarlanmamışsa İşletmeler için RCS platformu, dosyadan otomatik olarak bir küçük resim oluşturur. İşletmeler için RCS platformu, dosyayı getirirken HTTP üstbilgilerindeki içerik türü alanından dosyanın MIME türünü belirler.

Desteklenen resim içerik türleri: image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Zorunlu. Temsilcinin benzersiz tanımlayıcısı.

Yanıt metni

Aracının ileti gönderirken dosyayı tanımlamak için kullanabileceği, benzersiz ada sahip bir dosya kaynağı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "name": string
}
Alanlar
name

string

Dosya kaynağı için sunucu tarafından atanan benzersiz ad. Temsilciler, ileti gönderirken dosyayı tanımlamak için bu adı kullanabilir. Biçim "files/{uid}" şeklindedir. Burada {uid} benzersiz bir kimliktir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.