Bağlamı önbelleğe alma özelliği, önceden hesaplanmış ve tekrar tekrar kullanmak istediğiniz giriş parçalarını (ör. aynı medya dosyasıyla ilgili farklı sorular sorarken) kaydetmenize ve yeniden kullanmanıza olanak tanır. Bu, kullanıma bağlı olarak maliyet ve hız açısından tasarruf sağlayabilir. Ayrıntılı bir giriş için Bağlam önbelleğe alma kılavuzuna bakın.
Yöntem: cachedContents.create
CachedContent kaynağını oluşturur.
Uç nokta
posthttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
İstek metni
İstek metni, CachedContent öğesinin bir örneğini içerir.
contents[]
object (Content)
İsteğe bağlı. Yalnızca giriş. Değişmez. Önbelleğe alınacak içerik.
tools[]
object (Tool)
İsteğe bağlı. Yalnızca giriş. Değişmez. Modelin bir sonraki yanıtı oluşturmak için kullanabileceği Tools listesi
expiration
Union type
expiration aşağıdakilerden yalnızca biri olabilir:expireTime
string (Timestamp format)
Bu kaynağın geçerliliğinin sona erdiği zamanı gösteren UTC zaman damgası. Bu, girişte ne gönderildiğinden bağımsız olarak her zaman çıkışta sağlanır.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
ttl
string (Duration format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
displayName
string
İsteğe bağlı. Değişmez. Önbelleğe alınmış içeriğin kullanıcı tarafından oluşturulan anlamlı görünen adı. Maksimum 128 Unicode karakter.
model
string
Zorunlu. Değişmez. Önbelleğe alınmış içerik için kullanılacak Model adı. Biçim: models/{model}
systemInstruction
object (Content)
İsteğe bağlı. Yalnızca giriş. Değişmez. Geliştirici tarafından ayarlanan sistem talimatı. Şu anda yalnızca metin desteklenmektedir.
toolConfig
object (ToolConfig)
İsteğe bağlı. Yalnızca giriş. Değişmez. Araç yapılandırması Bu yapılandırma tüm araçlar için paylaşılır.
Örnek istek
Temel
Python
Node.js
Go
kabuk
Gönderen adı
Python
Node.js
Go
Sohbetten
Python
Node.js
Go
Yanıt metni
Başarılı olursa yanıt gövdesi, yeni oluşturulan bir CachedContent örneğini içerir.
Yöntem: cachedContents.list
Lists CachedContents.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
Sorgu parametreleri
pageSize
integer
İsteğe bağlı. Döndürülecek maksimum önbelleğe alınmış içerik sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse varsayılan olarak (maksimum değerin altında) belirli sayıda öğe döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.
pageToken
string
İsteğe bağlı. Önceki bir cachedContents.list çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
Sayfalara ayırma işlemi yapılırken cachedContents.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
İstek metni
İstek metni boş olmalıdır.
Yanıt metni
CachedContents listesi içeren yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
cachedContents[]
object (CachedContent)
Önbelleğe alınmış içeriklerin listesi.
nextPageToken
string
Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.
| JSON gösterimi |
|---|
{
"cachedContents": [
{
object ( |
Yöntem: cachedContents.get
CachedContent kaynağını okur.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Yol parametreleri
name
string
Zorunlu. İçerik önbelleği girişini ifade eden kaynak adı. Biçim: cachedContents/{id} cachedContents/{cachedcontent} biçimindedir.
İstek metni
İstek metni boş olmalıdır.
Örnek istek
Python
Node.js
Go
kabuk
Yanıt metni
Başarılıysa yanıt metni, CachedContent öğesinin bir örneğini içerir.
Yöntem: cachedContents.patch
CachedContent kaynağını günceller (yalnızca geçerlilik süresi güncellenebilir).
Uç nokta
patchhttps: / /generativelanguage.googleapis.com /v1beta /{cachedContent.name=cachedContents /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
Yol parametreleri
cachedContent.name
string
Yalnızca çıkış. Tanımlayıcı. Önbelleğe alınmış içeriği ifade eden kaynak adı. Biçim: cachedContents/{id} cachedContents/{cachedcontent} biçimindedir.
Sorgu parametreleri
updateMask
string (FieldMask format)
Güncellenecek alanların listesi.
Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "user.displayName,photo".
İstek metni
İstek metni, CachedContent öğesinin bir örneğini içerir.
expiration
Union type
expiration aşağıdakilerden yalnızca biri olabilir:expireTime
string (Timestamp format)
Bu kaynağın geçerliliğinin sona erdiği zamanı gösteren UTC zaman damgası. Bu, girişte ne gönderildiğinden bağımsız olarak her zaman çıkışta sağlanır.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
ttl
string (Duration format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
Örnek istek
Python
Node.js
Go
kabuk
Yanıt metni
Başarılıysa yanıt metni, CachedContent öğesinin bir örneğini içerir.
Yöntem: cachedContents.delete
CachedContent kaynağını siler.
Uç nokta
deletehttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Yol parametreleri
name
string
Zorunlu. İçerik önbelleği girişine atıfta bulunan kaynak adı. Biçim: cachedContents/{id} cachedContents/{cachedcontent} biçimindedir.
İstek metni
İstek metni boş olmalıdır.
Örnek istek
Python
Node.js
Go
kabuk
Yanıt metni
Başarılı olursa yanıt gövdesi boş bir JSON nesnesi olur.
REST Kaynağı: cachedContents
- Kaynak: CachedContent
- İçerik
- Bölüm
- Blob
- FunctionCall
- FunctionResponse
- FunctionResponsePart
- FunctionResponseBlob
- Planlama
- FileData
- ExecutableCode
- Dil
- CodeExecutionResult
- Sonuç
- ToolCall
- ToolType
- ToolResponse
- VideoMetadata
- MediaResolution
- Seviye
- Araç
- FunctionDeclaration
- Şema
- Tür
- Davranış
- GoogleSearchRetrieval
- DynamicRetrievalConfig
- Mod
- CodeExecution
- GoogleSearch
- Aralık
- SearchTypes
- WebSearch
- ImageSearch
- ComputerUse
- Ortam
- UrlContext
- FileSearch
- McpServer
- StreamableHttpTransport
- GoogleMaps
- ToolConfig
- FunctionCallingConfig
- Mod
- RetrievalConfig
- LatLng
- UsageMetadata
- Yöntemler
Kaynak: CachedContent
Önceden işlenmiş ve GenerativeService'e yapılan sonraki isteklerde kullanılabilen içerik.
Önbelleğe alınmış içerik yalnızca oluşturulduğu modelle kullanılabilir.
contents[]
object (Content)
İsteğe bağlı. Yalnızca giriş. Değişmez. Önbelleğe alınacak içerik.
tools[]
object (Tool)
İsteğe bağlı. Yalnızca giriş. Değişmez. Modelin bir sonraki yanıtı oluşturmak için kullanabileceği Tools listesi
createTime
string (Timestamp format)
Yalnızca çıkış. Önbellek girişinin oluşturulma zamanı.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime
string (Timestamp format)
Yalnızca çıkış. Önbellek girişinin son güncellendiği zaman (UTC).
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
usageMetadata
object (UsageMetadata)
Yalnızca çıkış. Önbelleğe alınmış içeriğin kullanımıyla ilgili meta veriler.
expiration
Union type
expiration aşağıdakilerden yalnızca biri olabilir:expireTime
string (Timestamp format)
Bu kaynağın geçerliliğinin sona erdiği zamanı gösteren UTC zaman damgası. Bu, girişte ne gönderildiğinden bağımsız olarak her zaman çıkışta sağlanır.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
ttl
string (Duration format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
name
string
Yalnızca çıkış. Tanımlayıcı. Önbelleğe alınmış içeriği ifade eden kaynak adı. Biçim: cachedContents/{id}
displayName
string
İsteğe bağlı. Değişmez. Önbelleğe alınmış içeriğin kullanıcı tarafından oluşturulan anlamlı görünen adı. Maksimum 128 Unicode karakter.
model
string
Zorunlu. Değişmez. Önbelleğe alınmış içerik için kullanılacak Model adı. Biçim: models/{model}
systemInstruction
object (Content)
İsteğe bağlı. Yalnızca giriş. Değişmez. Geliştirici tarafından ayarlanan sistem talimatı. Şu anda yalnızca metin desteklenmektedir.
toolConfig
object (ToolConfig)
İsteğe bağlı. Yalnızca giriş. Değişmez. Araç yapılandırması Bu yapılandırma tüm araçlar için paylaşılır.
| JSON gösterimi |
|---|
{ "contents": [ { object ( |
İçerik
Bir iletinin çok parçalı içeriğini içeren temel yapılandırılmış veri türü.
Bir Content, Content üreticisini belirten bir role alanı ve ileti dönüşünün içeriğini içeren çok parçalı verileri içeren bir parts alanı içerir.
parts[]
object (Part)
Tek bir iletiyi oluşturan Parts sıralanır. Bölümlerin MIME türleri farklı olabilir.
role
string
İsteğe bağlı. İçeriğin üreticisi. "user" veya "model" olmalıdır.
Çok turlu görüşmeler için ayarlanması yararlıdır. Aksi takdirde boş bırakılabilir veya ayarlanmayabilir.
| JSON gösterimi |
|---|
{
"parts": [
{
object ( |
Bölüm
Çok parçalı Content iletinin bir parçası olan medyayı içeren bir veri türü.
Bir Part, ilişkili bir veri türüne sahip verilerden oluşur. Bir Part yalnızca Part.data içinde kabul edilen türlerden birini içerebilir.
Part alanı, inlineData alanı ham baytlarla doldurulmuşsa medyanın türünü ve alt türünü tanımlayan sabit bir IANA MIME türüne sahip olmalıdır.
thought
boolean
İsteğe bağlı. Parçanın model tarafından oluşturulup oluşturulmadığını gösterir.
thoughtSignature
string (bytes format)
İsteğe bağlı. Düşünce için opak bir imza. Böylece, sonraki isteklerde yeniden kullanılabilir.
Base64 kodlu bir dize.
partMetadata
object (Struct format)
Parça ile ilişkili özel meta veriler. İçerik temsili olarak genai.Part kullanan aracıların ek bilgileri takip etmesi gerekebilir. Örneğin, Bölüm'ün geldiği dosyanın/kaynağın adı veya birden fazla Bölüm akışını çoklamanın bir yolu olabilir.
mediaResolution
object (MediaResolution)
İsteğe bağlı. Giriş medyasının medya çözünürlüğü.
data
Union type
data aşağıdakilerden yalnızca biri olabilir:text
string
Satır içi metin.
inlineData
object (Blob)
Satır içi medya baytları.
functionCall
object (FunctionCall)
Modelden döndürülen, bağımsız değişkenleri ve değerleriyle birlikte FunctionDeclaration.name'yi temsil eden bir dize içeren tahmini bir FunctionCall.
functionResponse
object (FunctionResponse)
FunctionCall işlevinin sonuç çıkışı, FunctionDeclaration.name işlevini temsil eden bir dize ve işlevden gelen tüm çıkışları içeren yapılandırılmış bir JSON nesnesi içerir. Bu çıkış, model için bağlam olarak kullanılır.
fileData
object (FileData)
URI tabanlı veriler.
executableCode
object (ExecutableCode)
Model tarafından oluşturulan ve yürütülmesi amaçlanan kod.
codeExecutionResult
object (CodeExecutionResult)
ExecutableCode yürütme sonucu.
toolCall
object (ToolCall)
Sunucu tarafı araç çağrısı. Bu alan, modelin sunucuda yürütülmesi gereken bir araç çağrısı tahmin ettiğinde doldurulur. İstemcinin bu mesajı API'ye geri göndermesi beklenir.
toolResponse
object (ToolResponse)
Sunucu tarafı ToolCall yürütülmesinden elde edilen çıkış. Bu alan, istemci tarafından ilgili ToolCall yürütme sonuçlarıyla doldurulur.
metadata
Union type
metadata aşağıdakilerden yalnızca biri olabilir:videoMetadata
object (VideoMetadata)
İsteğe bağlı. Video meta verileri Meta veriler yalnızca video verileri inlineData veya fileData içinde sunulurken belirtilmelidir.
| JSON gösterimi |
|---|
{ "thought": boolean, "thoughtSignature": string, "partMetadata": { object }, "mediaResolution": { object ( |
Blob
Ham medya baytları.
Metin, ham bayt olarak gönderilmemelidir. "Metin" alanı kullanılmalıdır.
mimeType
string
Kaynak verilerin IANA standardı MIME türü. Örnekler: - image/png - image/jpeg Desteklenmeyen bir MIME türü sağlanırsa hata döndürülür. Desteklenen türlerin tam listesi için Desteklenen dosya biçimleri başlıklı makaleyi inceleyin.
data
string (bytes format)
Medya biçimleri için ham baytlar.
Base64 kodlu bir dize.
| JSON gösterimi |
|---|
{ "mimeType": string, "data": string } |
FunctionCall
Modelden döndürülen, bağımsız değişkenleri ve değerleriyle birlikte FunctionDeclaration.name'yi temsil eden bir dize içeren tahmini bir FunctionCall.
id
string
İsteğe bağlı. İşlev çağrısının benzersiz tanımlayıcısı. Doldurulmuşsa istemci, functionCall öğesini yürütür ve yanıtı eşleşen id ile birlikte döndürür.
name
string
Zorunlu. Çağrılacak işlevin adı. a-z, A-Z, 0-9 olmalı veya alt çizgi ve tire içermeli ve maksimum uzunluğu 128 olmalıdır.
args
object (Struct format)
İsteğe bağlı. JSON nesnesi biçimindeki işlev parametreleri ve değerleri.
| JSON gösterimi |
|---|
{ "id": string, "name": string, "args": { object } } |
FunctionResponse
FunctionCall işlevinden elde edilen ve FunctionDeclaration.name işlevini temsil eden bir dize ile işlevden elde edilen tüm çıkışları içeren yapılandırılmış bir JSON nesnesi içeren sonuç çıkışı, model için bağlam olarak kullanılır. Bu, model tahminine dayalı bir FunctionCall sonucunu içermelidir.
id
string
İsteğe bağlı. Bu yanıtın ait olduğu işlev çağrısının tanımlayıcısı. İlgili işlev çağrısıyla eşleşmesi için istemci tarafından doldurulur id.
name
string
Zorunlu. Çağrılacak işlevin adı. a-z, A-Z, 0-9 olmalı veya alt çizgi ve tire içermeli ve maksimum uzunluğu 128 olmalıdır.
response
object (Struct format)
Zorunlu. JSON nesnesi biçimindeki işlev yanıtı. Arayanlar, işlevin çıktısını döndürmek için işlevin söz dizimine uyan herhangi bir anahtarı (ör. "output", "result" vb.) kullanabilir. Özellikle işlev çağrısı yürütülemezse yanıt, hata ayrıntılarını modele döndürmek için bir "error" anahtarı içerebilir.
parts[]
object (FunctionResponsePart)
İsteğe bağlı. İşlev yanıtını oluşturan sıralı Parts. Bölümlerin farklı IANA MIME türleri olabilir.
willContinue
boolean
İsteğe bağlı. İşlev çağrısının devam ettiğini ve daha fazla yanıt döndürüleceğini belirterek işlev çağrısını oluşturucuya dönüştürür. Yalnızca NON_BLOCKING işlev çağrıları için geçerlidir, aksi takdirde yoksayılır. Yanlış olarak ayarlanırsa gelecekteki yanıtlar dikkate alınmaz. İşlev çağrısının tamamlandığını belirtmek için response ile willContinue=False boş döndürmeye izin verilir. Bu işlem, model oluşturmayı yine de tetikleyebilir. Üretimi tetiklememek ve işlev çağrısını tamamlamak için scheduling değerini SILENT olarak da ayarlayın.
scheduling
enum (Scheduling)
İsteğe bağlı. Yanıtın görüşmede nasıl planlanacağını belirtir. Yalnızca NON_BLOCKING işlev çağrıları için geçerlidir, aksi takdirde yoksayılır. Varsayılan olarak WHEN_IDLE değerine ayarlanır.
| JSON gösterimi |
|---|
{ "id": string, "name": string, "response": { object }, "parts": [ { object ( |
FunctionResponsePart
FunctionResponse iletisinin bir parçası olan medyayı içeren bir veri türü.
Bir FunctionResponsePart, ilişkili bir veri türüne sahip verilerden oluşur. Bir FunctionResponsePart yalnızca FunctionResponsePart.data içinde kabul edilen türlerden birini içerebilir.
FunctionResponsePart alanı, inlineData alanı ham baytlarla doldurulmuşsa medyanın türünü ve alt türünü tanımlayan sabit bir IANA MIME türüne sahip olmalıdır.
data
Union type
data aşağıdakilerden yalnızca biri olabilir:inlineData
object (FunctionResponseBlob)
Satır içi medya baytları.
| JSON gösterimi |
|---|
{
// data
"inlineData": {
object ( |
FunctionResponseBlob
İşlev yanıtı için ham medya baytları.
Metin, ham bayt olarak gönderilmemelidir. "FunctionResponse.response" alanı kullanılmalıdır.
mimeType
string
Kaynak verilerin IANA standardı MIME türü. Örnekler: - image/png - image/jpeg Desteklenmeyen bir MIME türü sağlanırsa hata döndürülür. Desteklenen türlerin tam listesi için Desteklenen dosya biçimleri başlıklı makaleyi inceleyin.
data
string (bytes format)
Medya biçimleri için ham baytlar.
Base64 kodlu bir dize.
| JSON gösterimi |
|---|
{ "mimeType": string, "data": string } |
Planlama
Yanıtın görüşmede nasıl planlanacağını belirtir.
| Sıralamalar | |
|---|---|
SCHEDULING_UNSPECIFIED |
Bu değer kullanılmıyor. |
SILENT |
Yalnızca sonucu görüşme bağlamına ekle, üretimi kesintiye uğratma veya tetikleme. |
WHEN_IDLE |
Sonucu görüşme bağlamına ekleyin ve devam eden üretimi kesintiye uğratmadan çıkış oluşturma istemi gönderin. |
INTERRUPT |
Sonucu sohbet bağlamına ekleyin, devam eden üretimi durdurun ve çıkış oluşturmak için istemde bulunun. |
FileData
URI tabanlı veriler.
mimeType
string
İsteğe bağlı. Kaynak verilerin IANA standardı MIME türü.
fileUri
string
Zorunlu. URI.
| JSON gösterimi |
|---|
{ "mimeType": string, "fileUri": string } |
ExecutableCode
Model tarafından oluşturulan ve yürütülmesi amaçlanan kod ile sonucun modele döndürülmesi.
Yalnızca CodeExecution aracı kullanılırken oluşturulur. Bu araçta kod otomatik olarak yürütülür ve karşılık gelen bir CodeExecutionResult de oluşturulur.
id
string
İsteğe bağlı. ExecutableCode parçasının benzersiz tanımlayıcısı. Sunucu, eşleşen id ile birlikte CodeExecutionResult değerini döndürür.
language
enum (Language)
Zorunlu. code programlama dili.
code
string
Zorunlu. Yürütülecek kod.
| JSON gösterimi |
|---|
{
"id": string,
"language": enum ( |
Dil
Oluşturulan kod için desteklenen programlama dilleri.
| Sıralamalar | |
|---|---|
LANGUAGE_UNSPECIFIED |
Belirtilmemiş dil. Bu değer kullanılmamalıdır. |
PYTHON |
Python >= 3.10, numpy ve simpy kullanılabilir. Varsayılan dil Python'dur. |
CodeExecutionResult
ExecutableCode yürütme sonucu.
Yalnızca CodeExecution aracı kullanıldığında oluşturulur.
id
string
İsteğe bağlı. Bu sonucun ait olduğu ExecutableCode bölümünün tanımlayıcısı. Yalnızca ilgili ExecutableCode öğesinin kimliği varsa doldurulur.
outcome
enum (Outcome)
Zorunlu. Kod yürütmenin sonucu.
output
string
İsteğe bağlı. Kod yürütme başarılı olduğunda stdout, aksi takdirde stderr veya başka bir açıklama içerir.
| JSON gösterimi |
|---|
{
"id": string,
"outcome": enum ( |
Sonuç
Kod yürütmenin olası sonuçlarının numaralandırılması.
| Sıralamalar | |
|---|---|
OUTCOME_UNSPECIFIED |
Durum belirtilmemiş. Bu değer kullanılmamalıdır. |
OUTCOME_OK |
Kod yürütme başarıyla tamamlandı. output, varsa stdout'u içerir. |
OUTCOME_FAILED |
Kod yürütülemedi. output, varsa stderr ve stdout'u içerir. |
OUTCOME_DEADLINE_EXCEEDED |
Kod yürütme işlemi çok uzun sürdü ve iptal edildi. Kısmi bir output mevcut olabilir veya olmayabilir. |
ToolCall
Modelden tahmin edilen bir sunucu taraflı ToolCall döndürülür. Bu mesaj, modelin çağırmak istediği bir araçla ilgili bilgiler içeriyor. İstemcinin bu ToolCall'yı yürütmesi beklenmez. Bunun yerine, istemci bu ToolCall değerini Content mesajı içindeki sonraki dönüşte API'ye karşılık gelen ToolResponse ile birlikte geri iletmelidir.
id
string
İsteğe bağlı. Araç çağrısının benzersiz tanımlayıcısı. Sunucu, eşleşen id ile araç yanıtını döndürür.
toolType
enum (ToolType)
Zorunlu. Çağrılan aracın türü.
args
object (Struct format)
İsteğe bağlı. Araç çağrısı bağımsız değişkenleri. Örnek: {"arg1" : "value1", "arg2" : "value2" , ...}
| JSON gösterimi |
|---|
{
"id": string,
"toolType": enum ( |
ToolType
İşlev çağrısındaki aracın türü.
| Sıralamalar | |
|---|---|
TOOL_TYPE_UNSPECIFIED |
Belirtilmemiş araç türü. |
GOOGLE_SEARCH_WEB |
Google arama aracı, Tool.google_search.search_types.web_search ile eşlenir. |
GOOGLE_SEARCH_IMAGE |
Görsel arama aracı, Tool.google_search.search_types.image_search ile eşlenir. |
URL_CONTEXT |
URL bağlamı aracı, Tool.url_context ile eşlenir. |
GOOGLE_MAPS |
Google Haritalar aracı, Tool.google_maps ile eşlenir. |
FILE_SEARCH |
Dosya arama aracı, Tool.file_search ile eşlenir. |
ToolResponse
Sunucu tarafı ToolCall yürütülmesinden elde edilen çıkış. Bu mesaj, modelden gelen bir ToolCall tarafından başlatılan bir araç çağrısının sonuçlarını içerir. İstemci, bu ToolResponse değerini Content mesajı içinde sonraki dönüşte API'ye geri iletmelidir. Bu iletme işleminde, ilgili ToolCall değeri de yer almalıdır.
id
string
İsteğe bağlı. Bu yanıtın ait olduğu araç çağrısının tanımlayıcısı.
toolType
enum (ToolType)
Zorunlu. Çağrılan aracın türü, ilgili ToolCall içindeki toolType ile eşleşir.
response
object (Struct format)
İsteğe bağlı. Aracın yanıtı.
| JSON gösterimi |
|---|
{
"id": string,
"toolType": enum ( |
VideoMetadata
Desteği sonlandırıldı: Bunun yerine GenerateContentRequest.processing_options politikasını kullanın. Meta veriler, giriş video içeriğini tanımlar.
startOffset
string (Duration format)
İsteğe bağlı. Videonun başlangıç uzaklığı.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
endOffset
string (Duration format)
İsteğe bağlı. Videonun bitiş uzaklığı.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
fps
number
İsteğe bağlı. Modele gönderilen videonun kare hızı. Belirtilmezse varsayılan değer 1, 0 olur. FPS aralığı (0,0, 24,0]'dır.
| JSON gösterimi |
|---|
{ "startOffset": string, "endOffset": string, "fps": number } |
MediaResolution
Token oluşturma için medya çözünürlüğü.
value
Union type
value aşağıdakilerden yalnızca biri olabilir:level
enum (Level)
Belirli bir medya için kullanılan jetonlaştırma kalitesi.
| JSON gösterimi |
|---|
{
// value
"level": enum ( |
Seviye
Medya çözünürlük düzeyi.
| Sıralamalar | |
|---|---|
MEDIA_RESOLUTION_UNSPECIFIED |
Medya çözünürlüğü ayarlanmamış. |
MEDIA_RESOLUTION_LOW |
Medya çözünürlüğü düşük olarak ayarlanmış. |
MEDIA_RESOLUTION_MEDIUM |
Medya çözünürlüğü orta olarak ayarlanmış olmalıdır. |
MEDIA_RESOLUTION_HIGH |
Medya çözünürlüğü yüksek olarak ayarlanmış. |
MEDIA_RESOLUTION_ULTRA_HIGH |
Medya çözünürlüğü ultra yüksek olarak ayarlanmış. |
Araç
Modelin yanıt oluşturmak için kullanabileceği araç ayrıntıları.
Tool, sistemin modelin bilgisi ve kapsamı dışında bir işlem veya işlemler dizisi gerçekleştirmek için harici sistemlerle etkileşime girmesini sağlayan bir kod parçasıdır.
Next ID: 15
functionDeclarations[]
object (FunctionDeclaration)
İsteğe bağlı. Modelin işlev çağrısı için kullanabileceği FunctionDeclarations listesi.
Model veya sistem işlevi yürütmüyor. Bunun yerine, tanımlanan işlev, yürütme için istemci tarafına bağımsız değişkenlerle birlikte FunctionCall olarak döndürülebilir. Model, yanıtta FunctionCall öğesini doldurarak bu işlevlerin bir alt kümesini çağırmaya karar verebilir. Bir sonraki konuşma sırası, bir sonraki model sırası için Content.role "işlev" oluşturma bağlamıyla birlikte FunctionResponse içerebilir.
googleSearchRetrieval
object (GoogleSearchRetrieval)
İsteğe bağlı. Google Arama tarafından desteklenen bir alma aracı.
codeExecution
object (CodeExecution)
İsteğe bağlı. Modelin, oluşturma işlemi kapsamında kod yürütmesini sağlar.
googleSearch
object (GoogleSearch)
İsteğe bağlı. Google Arama aracı türü. Modelde Google Arama'yı destekleyen araç. Google tarafından desteklenmektedir.
computerUse
object (ComputerUse)
İsteğe bağlı. Modelin doğrudan bilgisayarla etkileşim kurmasını destekleyen araç. Etkinleştirilirse bilgisayar kullanımına özgü İşlev Bildirimleri otomatik olarak doldurulur.
urlContext
object (UrlContext)
İsteğe bağlı. URL bağlamı almayı destekleyen araç.
fileSearch
object (FileSearch)
İsteğe bağlı. FileSearch araç türü. Semantik Alma korpuslarından bilgi almak için kullanılan araç.
mcpServers[]
object (McpServer)
İsteğe bağlı. Bağlanılacak MCP sunucuları.
googleMaps
object (GoogleMaps)
İsteğe bağlı. Modelin yanıtını, kullanıcının sorgusuyla ilgili coğrafi bağlamla temellendirmeye olanak tanıyan araç.
| JSON gösterimi |
|---|
{ "functionDeclarations": [ { object ( |
FunctionDeclaration
OpenAPI 3.03 spesifikasyonunda tanımlandığı şekilde bir fonksiyon bildiriminin yapılandırılmış gösterimi. Bu bildirime işlev adı ve parametreler dahildir. Bu FunctionDeclaration, model tarafından Tool olarak kullanılabilen ve istemci tarafından yürütülebilen bir kod bloğunun gösterimidir.
name
string
Zorunlu. İşlevin adı. a-z, A-Z, 0-9 olmalı veya alt çizgi, iki nokta, nokta ve kısa çizgi içermeli ve en fazla 128 karakter uzunluğunda olmalıdır.
description
string
Zorunlu. İşlevin kısa bir açıklaması.
behavior
enum (Behavior)
İsteğe bağlı. İşlev davranışını belirtir. Şu anda yalnızca BidiGenerateContent yöntemi tarafından desteklenmektedir.
parameters
object (Schema)
İsteğe bağlı. Bu işlevin parametrelerini açıklar. Open API 3.03 Parametre Nesnesi dize Anahtarını yansıtır: parametrenin adı. Parametre adları büyük/küçük harfe duyarlıdır. Şema Değeri: Parametre için kullanılan türü tanımlayan şema.
parametersJsonSchema
value (Value format)
İsteğe bağlı. İşlevin parametrelerini JSON şeması biçiminde açıklar. Şema, özelliklerin işlevin parametreleri olduğu bir nesneyi tanımlamalıdır. Örneğin:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"age": { "type": "integer" }
},
"additionalProperties": false,
"required": ["name", "age"],
"propertyOrdering": ["name", "age"]
}
Bu alan parameters ile birlikte kullanılamaz.
response
object (Schema)
İsteğe bağlı. Bu işlevin çıktısını JSON şema biçiminde açıklar. Open API 3.03 Response Object'i yansıtır. Şema, işlevin yanıt değeri için kullanılan türü tanımlar.
responseJsonSchema
value (Value format)
İsteğe bağlı. Bu işlevin çıktısını JSON şema biçiminde açıklar. Şema tarafından belirtilen değer, işlevin yanıt değeridir.
Bu alan response ile birlikte kullanılamaz.
Şema
Schema nesnesi, giriş ve çıkış veri türlerinin tanımlanmasına olanak tanır. Bu türler nesne olabileceği gibi temel türler ve diziler de olabilir. OpenAPI 3.0 şema nesnesinin belirli bir alt kümesini temsil eder.
type
enum (Type)
Zorunlu. Veri türü.
format
string
İsteğe bağlı. Verilerin biçimi. Herhangi bir değere izin verilir ancak çoğu özel bir işlevi tetiklemez.
title
string
İsteğe bağlı. Şemanın başlığı.
description
string
İsteğe bağlı. Parametrenin kısa bir açıklaması. Kullanım örnekleri içerebilir. Parametre açıklaması Markdown olarak biçimlendirilebilir.
nullable
boolean
İsteğe bağlı. Değerin boş olup olamayacağını gösterir.
enum[]
string
İsteğe bağlı. Enum biçimli Type.STRING öğesinin olası değerleri. Örneğin, bir Enum Direction'ı şu şekilde tanımlayabiliriz : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
maxItems
string (int64 format)
İsteğe bağlı. Type.ARRAY için maksimum öğe sayısı.
minItems
string (int64 format)
İsteğe bağlı. Type.ARRAY için minimum öğe sayısı.
properties
map (key: string, value: object (Schema))
İsteğe bağlı. Type.OBJECT'in özellikleri.
"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
required[]
string
İsteğe bağlı. Type.OBJECT için zorunlu özellikler.
minProperties
string (int64 format)
İsteğe bağlı. Type.OBJECT için minimum özellik sayısı.
maxProperties
string (int64 format)
İsteğe bağlı. Type.OBJECT için maksimum özellik sayısı.
minLength
string (int64 format)
İsteğe bağlı. TÜR DİZESİ İÇİN ŞEMA ALANLARI Tür.DİZE'nin minimum uzunluğu
maxLength
string (int64 format)
İsteğe bağlı. Type.STRING'in maksimum uzunluğu
pattern
string
İsteğe bağlı. Bir dizeyi normal ifadeyle sınırlamak için Type.STRING kalıbı.
example
value (Value format)
İsteğe bağlı. Nesne örneği. Yalnızca nesne kök olduğunda doldurulur.
anyOf[]
object (Schema)
İsteğe bağlı. Değer, listedeki alt şemalardan herhangi biri (bir veya daha fazla) ile doğrulanmalıdır.
propertyOrdering[]
string
İsteğe bağlı. Özelliklerin sırası. Açık API spesifikasyonunda standart bir alan değildir. Yanıttaki özelliklerin sırasını belirlemek için kullanılır.
default
value (Value format)
İsteğe bağlı. Alanın varsayılan değeri. JSON şemasına göre bu alan, dokümantasyon oluşturucular için tasarlanmıştır ve doğrulamayı etkilemez. Bu nedenle, default alanı içeren şemalar gönderen geliştiricilerin bilinmeyen alan hataları almaması için buraya dahil edilmiş ve yok sayılmıştır.
items
object (Schema)
İsteğe bağlı. Type.ARRAY türündeki öğelerin şeması.
minimum
number
İsteğe bağlı. TÜR TAM SAYI VE SAYI İÇİN ŞEMA ALANLARI Türün minimum değeri.TAM SAYI ve Tür.SAYI
maximum
number
İsteğe bağlı. Type.INTEGER ve Type.NUMBER'ın maksimum değeri
| JSON gösterimi |
|---|
{ "type": enum ( |
Tür
Tür, https://spec.openapis.org/oas/v3.0.3#data-types tarafından tanımlanan OpenAPI veri türlerinin listesini içerir.
| Sıralamalar | |
|---|---|
TYPE_UNSPECIFIED |
Belirtilmediğinden kullanılmamalıdır. |
STRING |
Dize türü. |
NUMBER |
Numara türü. |
INTEGER |
Tam sayı türü. |
BOOLEAN |
Boole türü. |
ARRAY |
Dizi türü. |
OBJECT |
Nesne türü. |
NULL |
Boş tür. |
Davranış
Fonksiyon davranışını tanımlar. Varsayılan olarak BLOCKING değerine ayarlanır.
| Sıralamalar | |
|---|---|
UNSPECIFIED |
Bu değer kullanılmıyor. |
BLOCKING |
Ayarlanırsa sistem, sohbete devam etmeden önce işlev yanıtını almayı bekler. |
NON_BLOCKING |
Ayarlanırsa sistem, işlev yanıtının alınmasını beklemez. Bunun yerine, kullanıcı ile model arasındaki görüşmeyi sürdürürken işlev yanıtlarını kullanıma sunuldukça işlemeye çalışır. |
GoogleSearchRetrieval
Google tarafından desteklenen, temellendirme için herkese açık web verilerini alma aracı.
dynamicRetrievalConfig
object (DynamicRetrievalConfig)
Belirli bir kaynak için dinamik alma yapılandırmasını belirtir.
| JSON gösterimi |
|---|
{
"dynamicRetrievalConfig": {
object ( |
DynamicRetrievalConfig
Dinamik almayı özelleştirme seçeneklerini açıklar.
mode
enum (Mode)
Dinamik alma işleminde kullanılacak tahmin edicinin modu.
dynamicThreshold
number
Dinamik alma işleminde kullanılacak eşik. Ayarlanmazsa sistemin varsayılan değeri kullanılır.
| JSON gösterimi |
|---|
{
"mode": enum ( |
Mod
Dinamik alma işleminde kullanılacak tahmin edicinin modu.
| Sıralamalar | |
|---|---|
MODE_UNSPECIFIED |
Her zaman almayı tetikleyin. |
MODE_DYNAMIC |
Yalnızca sistemin gerekli olduğuna karar verdiği durumlarda alma işlemini çalıştırın. |
CodeExecution
Bu türde alan yok.
Model tarafından oluşturulan kodu yürüten ve sonucu otomatik olarak modele döndüren araç.
Bu araç yalnızca kullanıldığında oluşturulan ExecutableCode ve CodeExecutionResult simgelerini de inceleyin.
GoogleSearch
Google Arama aracı türü. Modelde Google Arama'yı destekleyen araç. Google tarafından desteklenmektedir.
timeRangeFilter
object (Interval)
İsteğe bağlı. Arama sonuçlarını belirli bir zaman aralığına göre filtreleme Müşteriler bir başlangıç zamanı ayarlarsa bitiş zamanı da ayarlamalıdır (veya tam tersi).
searchTypes
object (SearchTypes)
İsteğe bağlı. Etkinleştirilecek arama türleri grubu. Ayarlanmazsa web araması varsayılan olarak etkindir.
| JSON gösterimi |
|---|
{ "timeRangeFilter": { object ( |
Aralık
Bir zaman aralığını, Başlangıç zaman damgası (dahil) ve Bitiş zaman damgası (hariç) olarak kodlanmış şekilde gösterir.
Başlangıç değeri, bitiş değerinden küçük veya ona eşit olmalıdır. Başlangıç ve bitiş aynı olduğunda aralık boştur (hiçbir zamanla eşleşmez). Hem başlangıç hem de bitiş belirtilmediğinde aralık herhangi bir zamana karşılık gelir.
startTime
string (Timestamp format)
İsteğe bağlı. Aralığın başlangıç zamanı dahildir.
Bu aralıkla eşleşen bir zaman damgası belirtilirse başlangıçla aynı veya başlangıçtan sonra olmalıdır.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
endTime
string (Timestamp format)
İsteğe bağlıdır. Aralığın bitiş zamanı dahil değildir.
Bu aralıkla eşleşen bir zaman damgası belirtilirse bitişten önce olmalıdır.
Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
| JSON gösterimi |
|---|
{ "startTime": string, "endTime": string } |
SearchTypes
GoogleSearch aracında etkinleştirilebilen farklı arama türleri.
webSearch
object (WebSearch)
İsteğe bağlı. Web aramayı etkinleştirir. Yalnızca metin sonuçları döndürülür.
imageSearch
object (ImageSearch)
İsteğe bağlı. Görsel arama özelliğini etkinleştirir. Resim baytları döndürülür.
| JSON gösterimi |
|---|
{ "webSearch": { object ( |
WebSearch
Bu türde alan yok.
Temellendirme ve ilgili yapılandırmalar için standart web araması.
ImageSearch
Bu türde alan yok.
Temellendirme ve ilgili yapılandırmalar için görsel arama.
ComputerUse
Bilgisayar Kullanımı araç türü.
environment
enum (Environment)
Zorunlu. Çalıştırılan ortam.
excludedPredefinedFunctions[]
string
İsteğe bağlı. Varsayılan olarak, önceden tanımlanmış işlevler nihai model çağrısına dahil edilir. Bunlardan bazıları, otomatik olarak dahil edilmemek üzere açıkça hariç tutulabilir. Bu, iki amaca hizmet edebilir: 1. Daha kısıtlı veya farklı bir işlem alanı kullanma 2. Önceden tanımlanmış işlevlerin tanımlarını / talimatlarını iyileştirme.
| JSON gösterimi |
|---|
{
"environment": enum ( |
Ortam
Web tarayıcısı gibi çalıştırılan ortamı temsil eder.
| Sıralamalar | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
Varsayılan olarak tarayıcıdır. |
ENVIRONMENT_BROWSER |
Web tarayıcısında çalışır. |
UrlContext
Bu türde alan yok.
URL bağlamı almayı destekleyen araç.
FileSearch
Semantic Retrieval korpuslarından bilgi alan FileSearch aracı. Dosyalar, ImportFile API kullanılarak Semantic Retrieval korpuslarına aktarılır.
fileSearchStoreNames[]
string
Zorunlu. Alınacak fileSearchStore'ların adları. Örnek: fileSearchStores/my-file-search-store-123
metadataFilter
string
İsteğe bağlı. Anlamsal alma belgelerine ve parçalarına uygulanacak meta veri filtresi.
topK
integer
İsteğe bağlı. Alınacak anlamsal alma parçalarının sayısı.
| JSON gösterimi |
|---|
{ "fileSearchStoreNames": [ string ], "metadataFilter": string, "topK": integer } |
McpServer
MCPServer, model tarafından işlem gerçekleştirmek için çağrılabilen bir sunucudur. Bu, MCP protokolünü uygulayan bir sunucudur. Sonraki kimlik: 5
name
string
MCPServer'ın adı.
transport
Union type
transport aşağıdakilerden yalnızca biri olabilir:streamableHttpTransport
object (StreamableHttpTransport)
HTTP isteklerini ve yanıtlarını yayınlayabilen bir aktarım.
| JSON gösterimi |
|---|
{
"name": string,
// transport
"streamableHttpTransport": {
object ( |
StreamableHttpTransport
HTTP isteklerini ve yanıtlarını yayınlayabilen bir aktarım. Sonraki kimlik: 6
url
string
MCPServer uç noktasının tam URL'si. Örnek: "https://api.example.com/mcp"
headers
map (key: string, value: string)
İsteğe bağlı: Gerekirse kimlik doğrulama başlıkları, zaman aşımları vb. için alanlar.
"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
timeout
string (Duration format)
Normal işlemler için HTTP zaman aşımı.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
sseReadTimeout
string (Duration format)
SSE okuma işlemleri için zaman aşımı.
En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
terminateOnClose
boolean
İletim kapatıldığında istemci oturumunun kapatılıp kapatılmayacağı.
| JSON gösterimi |
|---|
{ "url": string, "headers": { string: string, ... }, "timeout": string, "sseReadTimeout": string, "terminateOnClose": boolean } |
GoogleMaps
Kullanıcının sorgusu için coğrafi bağlam sağlayan Google Haritalar Aracı.
enableWidget
boolean
İsteğe bağlı. Yanıttaki GroundingMetadata'da widget bağlamı jetonunun döndürülüp döndürülmeyeceği. Geliştiriciler, modelin yanıtta referans verdiği yerlerle ilgili coğrafi alan bağlamına sahip bir Google Haritalar widget'ı oluşturmak için widget bağlam jetonunu kullanabilir.
| JSON gösterimi |
|---|
{ "enableWidget": boolean } |
ToolConfig
İsteklerde Tool kullanımını belirten parametreleri içeren araç yapılandırması.
functionCallingConfig
object (FunctionCallingConfig)
İsteğe bağlı. İşlev çağırma yapılandırması.
retrievalConfig
object (RetrievalConfig)
İsteğe bağlı. Alma yapılandırması.
includeServerSideToolInvocations
boolean
İsteğe bağlı. Doğruysa API yanıtı, Content mesajında sunucu tarafı araç çağrılarını ve yanıtlarını içerir. Bu sayede istemciler, sunucunun araç etkileşimlerini gözlemleyebilir.
| JSON gösterimi |
|---|
{ "functionCallingConfig": { object ( |
FunctionCallingConfig
İşlev çağrısı davranışını belirtmeye yönelik yapılandırma.
mode
enum (Mode)
İsteğe bağlı. İşlev çağrısının yürütülmesi gereken modu belirtir. Belirtilmezse varsayılan değer AUTO olarak ayarlanır.
allowedFunctionNames[]
string
İsteğe bağlı. Belirtildiğinde modelin çağıracağı işlevleri sınırlayan bir işlev adı grubu.
Bu özellik yalnızca Mod ANY veya VALIDATED olduğunda ayarlanmalıdır. İşlev adları [FunctionDeclaration.name] ile eşleşmelidir. Ayarlanırsa model, yalnızca izin verilen işlev adlarından bir işlev çağrısı tahmin eder.
| JSON gösterimi |
|---|
{
"mode": enum ( |
Mod
Yürütme modunu tanımlayarak işlev çağrısı için yürütme davranışını tanımlar.
| Sıralamalar | |
|---|---|
MODE_UNSPECIFIED |
Belirtilmemiş işlev çağrısı modu. Bu değer kullanılmamalıdır. |
AUTO |
Varsayılan model davranışı: Model, işlev çağrısı veya doğal dil yanıtı tahmin etmeye karar verir. |
ANY |
Model, her zaman yalnızca bir işlev çağrısı tahmin etmeye zorlanır. "allowedFunctionNames" ayarlanmışsa tahmin edilen işlev çağrısı, "allowedFunctionNames" değerlerinden biriyle sınırlı olur. Aksi takdirde tahmin edilen işlev çağrısı, sağlanan "functionDeclarations" değerlerinden biri olur. |
NONE |
Model herhangi bir işlev çağrısını tahmin etmez. Model davranışı, herhangi bir işlev bildirimi iletilmediğinde olduğu gibidir. |
VALIDATED |
Model, işlev çağrısı veya doğal dil yanıtı tahmin etmeye karar verir ancak işlev çağrılarını kısıtlanmış kod çözme ile doğrular. "allowedFunctionNames" ayarlanmışsa tahmin edilen işlev çağrısı, "allowedFunctionNames" değerlerinden biriyle sınırlı olur. Aksi takdirde tahmin edilen işlev çağrısı, sağlanan "functionDeclarations" değerlerinden biri olur. |
RetrievalConfig
LatLng
Bir enlem/boylam çiftini temsil eden nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.
latitude
number
Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude
number
Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.
| JSON gösterimi |
|---|
{ "latitude": number, "longitude": number } |
UsageMetadata
Önbelleğe alınmış içeriğin kullanımıyla ilgili meta veriler.
totalTokenCount
integer
Önbelleğe alınan içeriğin kullandığı toplam jeton sayısı.
| JSON gösterimi |
|---|
{ "totalTokenCount": integer } |