Method: alerts.list

Uyarıları listeler.

HTTP isteği

GET https://alertcenter.googleapis.com/v1beta1/alerts

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

Sorgu parametreleri

Parametreler
customerId

string

İsteğe bağlı. Uyarıların ilişkilendirildiği müşterinin Google Workspace hesabının benzersiz tanımlayıcısı. customerId, ilk "C" harfini içermelidir soyutlanır (örneğin, 046psxkn). Belirtilmediyse arayan kimliğinden tahmin edilir. Müşteri kimliğinizi bulma

pageSize

integer

İsteğe bağlı. İstenen sayfa boyutu. Sunucu, istenenden daha az öğe döndürebilir. Belirtilmemişse sunucu uygun bir varsayılan seçer.

pageToken

string

İsteğe bağlı. Sunucunun döndürmesi gereken sonuçların yer aldığı sayfayı tanımlayan jeton. Boşsa yeni bir iterasyon başlatılır. Bir iterasyona devam etmek için önceki ListAlertsResponse'un nextPageToken alanındaki değeri iletin.

filter

string

İsteğe bağlı. Uyarı sonuçlarını filtrelemek için bir sorgu dizesi. Daha ayrıntılı bilgi için Sorgu filtreleri ve Desteklenen sorgu filtresi alanları başlıklı makaleleri inceleyin.

orderBy

string

İsteğe bağlı. Liste sonuçlarının sıralama düzeni. Belirtilmezse sonuçlar rastgele sırada döndürülebilir. orderBy="createTime desc" kullanarak sonuçları, oluşturma zaman damgasına göre azalan düzende sıralayabilirsiniz. Şu anda createTime asc, createTime desc, updateTime desc desteklenmektedir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Uyarı listeleme isteği için yanıt mesajı.

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

JSON gösterimi
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Alanlar
alerts[]

object (Alert)

Uyarıların listesi.

nextPageToken

string

Bir sonraki sayfanın jetonu. Boş değilse listeleme isteğiyle eşleşen daha fazla uyarı olabileceğini belirtir; bu değer, geçerli liste çağrısının son sonucundan itibaren devam eden uyarıları almak için sonraki bir ListAlertsRequest içinde kullanılabilir.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/apps.alerts

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.