Security Insights API, Chrome Security Insights özelliğini etkinleştirmenize veya devre dışı bırakmanıza, etkinleştirme durumunu kontrol etmenize ve analiz verilerini (ör. içerik aktarımları ve URL ziyaretleri) sorgulamanıza olanak tanır.
API yöntemlerine hızlı genel bakış
URL'ler https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER ile ilgilidir.
| Açıklama | Göreli URL | Http method | İzin verilen istek parametreleri |
|---|---|---|---|
| Alanınız için analizleri etkinleştirme ve Chrome bağlayıcılarını kök kuruluş birimi/alanınızdaki belirli bir kuruluş birimi grubu için yapılandırma | /enterprise/securityInsights:enable | POST | İsteğe bağlı: targetOus |
| Alanınız için analizleri devre dışı bırakma | /enterprise/securityInsights:disable | POST | |
| Alanınız için analizlerin etkinleştirme durumunu kontrol etme | /enterprise/securityInsights:checkEnablementStatus | YouTube'daki | |
| Alanınız için üst düzey içerik aktarma özetlerini sorgulama | /enterprise/securityInsights:queryContentTransfers | YouTube'daki | İsteğe bağlı: filtre |
| Kullanıcıya/alana/içerik kategorisine göre dökümler içeren sorgu içerik aktarımı özetleri | /enterprise/securityInsights:queryContentTransfersBreakdowns | YouTube'daki | İsteğe bağlı: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| Alanınız için üst düzey URL ziyaret özetlerini sorgulama | /enterprise/securityInsights:queryUrlVisits | YouTube'daki | İsteğe bağlı: filtre |
| Kullanıcıya/alan adına göre dökümler içeren URL ziyaret özetlerini sorgulama | /enterprise/securityInsights:queryUrlVisitsBreakdowns | YouTube'daki | İsteğe bağlı: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
Örnek istekler ve yanıtlar için kod örneklerine bakın.
Abonelik şartları
Aşağıdaki API yöntemleri için etkin bir Chrome Enterprise Premium aboneliği gerekir. Müşterinin bu aboneliği yoksa istekler engellenmez ancak sorgu sonuçları boş olur.
queryUrlVisitsqueryUrlVisitsBreakdowns
Yönetici ayrıcalıkları
Hangi yöntemin çağrıldığına bağlı olarak farklı yönetici ayrıcalıkları gerekir.
| Yöntem | Yönetici ayrıcalıkları gereklidir |
|---|---|
| enable | "Kuruluş Birimleri > Okuma" "Hizmetler > Chrome Yönetimi > Ayarlar > Kullanıcı Ayarlarını Yönet" "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını yönetme" |
| disable | "Kuruluş Birimleri > Okuma" "Hizmetler > Chrome Yönetimi > Ayarlar > Kullanıcı Ayarlarını Yönet" "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını yönetme" |
| checkEnablementStatus | "Kuruluş Birimleri > Okuma" "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını yönetme" VEYA "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını görüntüleme" |
| queryContentTransfers | "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını görüntüleme" |
| queryContentTransfersBreakdowns | "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını görüntüleme" |
| queryUrlVisits | "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını görüntüleme" |
| queryUrlVisitsBreakdowns | "Hizmetler > Chrome Veri Kaybını Önleme > Chrome Veri Kaybını Önleme uygulama analizi ayarlarını görüntüleme" |
Yönetici rollerini ve ayrıcalıklarını yönetmek için "Yönetici Konsolu -> Yönetici Rolleri"ni ziyaret edin.
API kapsamları
API'leri etkinleştirmek ve devre dışı bırakmak için aşağıdaki OAuth kapsamı gerekir:
https://www.googleapis.com/auth/chrome.management.securityinsights
checkEnablementStatus ve tüm sorgu yöntemleri için aşağıdaki iki kapsamdan biri kullanılabilir:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleyi inceleyin.