Method: files.create

Medya veya zengin kart mesajlarında kullanılmak üzere bir dosya yükler.

Temsilci, 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: RBM platformu, kullanıcı gizliliği ve güvenliği için medya ve PDF dosyalarını kullanıcıya sunmadan önce sağlanan URL'lerden indirip işler. Bu, benzersiz URL'lere göre temsilci takibini engeller. Bu nedenle, çok sayıda benzersiz URL göndermeyin. URL'lerin aynı veya farklı dosyaları işaretlemesi fark etmeksizin RBM platformu bunu desteklemez. Aynı dosyalar için aynı URL'yi kullanın.

RBM platformu dosyayı 60 gün boyunca önbelleğe alır ve müşteri temsilcisi mesajları gönderirken dosyayı tanımlamak için kullanabileceğiniz benzersiz bir ad döndürür.

Bir dosya ikilisini 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, --upload-file cURL işaretini ikili dosyanın tam olarak belirtilmiş dosya yolu ile 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 içeriği

İstek metni 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ı. Dosyanın herkese açık URL'si. RBM platformu, dosyayı getirirken HTTP üstbilgilerindeki content-type alanından dosyanın MIME türünü belirler. RBM; 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.
thumbnailUrl

string

İsteğe bağlı. Dosyaya karşılık gelen küçük resmin herkese açık URL'si. Bu alan ayarlanmazsa RBM platformu, dosyadan otomatik olarak bir küçük resim oluşturur. RBM platformu, dosyayı getirirken HTTP üstbilgilerindeki content-type 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 gövdesi

Temsilcinin, ileti gönderirken dosyayı tanımlamak için kullanabileceği benzersiz bir ada sahip 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ğının sunucu tarafından atanan benzersiz adı. Temsilci, 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.