Method: properties.chat

API aracılığıyla Google Analytics verileriyle etkileşim kurmak için bir sohbet arayüzü sağlar.

Bu ürün yapay zeka kullanıyor ve yanlış bilgiler gösterebilir. Sohbet etkinliğiniz, ürünü iyileştirmek için kullanılabilir. Bu ürünü kullanımınız Google'ın Şartları, Yapay Zeka Kullanım Politikası ve Gizlilik Politikası'na tabidir. properties.chat Yapay Zeka Gizliliği hakkında daha fazla bilgi edinin.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:chat

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

Yol parametreleri

Parametreler
property

string

Zorunlu. Hakkında sohbet edilecek mülk. Biçim: properties/{property}

İstek metni

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

JSON gösterimi 
{
  "userQuery": string,
  "returnPropertyQuota": boolean,
  "sessionId": string
}
Alanlar
userQuery

string

Zorunlu. Kullanıcının sorgusu.
returnPropertyQuota

boolean

İsteğe bağlı. Doğruysa yanıtta bu Analytics mülkünün kotasının mevcut durumu yer alır. Kota, PropertyChatQuota içinde döndürülür.
sessionId

string

İsteğe bağlı. Mevcut bir sohbete devam etmek ve bağlamı korumak için bu oturum kimliğini sağlayın. Bu alan boşsa veya ayarlanmamışsa yeni bir sohbet oturumu oluşturulur. Geçersiz oturum kimlikleri hataya neden olur.

Yanıt metni

properties.chat yöntemi için yanıt mesajı.

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

JSON gösterimi 
{
  "sessionId": string,
  "blocks": [
    {
      object (ResponseBlock)
    }
  ],
  "propertyQuota": {
    object (PropertyChatQuota)
  }
}
Alanlar
sessionId

string

Bu sohbet oturumunun benzersiz tanımlayıcısı. Sohbet bağlamını korumak için sonraki isteklerde bu kimliği sağlayın.
blocks[]

object (ResponseBlock)

Sohbet yanıtını oluşturan yanıt blokları. Metin, tablolar ve listeler bu kapsamda yer alabilir.
propertyQuota

object (PropertyChatQuota)

Bu Analytics mülkünün, bu isteği de içeren kota durumu.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/analytics.chatbot.read

ResponseBlock

Sohbet yanıtında bir yapılandırılmış veri bloğu.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "table": {
    object (DataTable)
  }
  // End of mutually exclusive fields.
}
Alanlar
Bir yapılandırılmış veri bloğu. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
text

string

Metin bloğu.
table

object (DataTable)

Tablo verilerinin bir bloğu.
Karşılıklı olarak hariç tutulan alanların sonu.

DataTable

Veri tablosu.

JSON gösterimi 
{
  "headers": [
    {
      object (DataTableHeader)
    }
  ],
  "rows": [
    {
      object (DataTableRow)
    }
  ]
}
Alanlar
headers[]

object (DataTableHeader)

Boyut sütunlarını açıklar. Üstbilgi sayısı ve üstbilgilerin sırası, satırlarda bulunan boyutlarla eşleşmelidir.
rows[]

object (DataTableRow)

Rapordaki boyut değeri kombinasyonları ve metrik değerleri satırları.

DataTableHeader

DataTable'daki bir sütun başlığını açıklar.

JSON gösterimi 
{
  "header": string,
  "dataType": string
}
Alanlar
header

string

Başlık adı.
dataType

string

Veri türü.

DataTableRow

DataTable'daki bir satır.

JSON gösterimi 
{
  "columns": [
    {
      object (DataTableCell)
    }
  ]
}
Alanlar
columns[]

object (DataTableCell)

Satırdaki hücre değerleri.

DataTableCell

Veri tablosundaki bir hücre.

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

string

Hücrenin değeri.

PropertyChatQuota

Chatbot'a özgü alanlar için mülk kotası.

JSON gösterimi 
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  }
}
Alanlar
tokensPerDay

object (QuotaStatus)

properties.chat için günlük kullanılan jeton sayısı.
tokensPerHour

object (QuotaStatus)

properties.chat tokens consumed per hour.