Bu dokümanda, Yönetici Ayarları API'sine özgü yetkilendirme ve kimlik doğrulama bilgileri bulunmaktadır. Bu dokümanı okumadan önce Kimlik doğrulama ve yetkilendirme hakkında bilgi edinme başlıklı makalede Google Workspace'in genel kimlik doğrulama ve yetkilendirme bilgilerini okuyun.
Uygulamanıza verilen erişim düzeyini tanımlamak için yetkilendirme kapsamlarını tanımlamanız ve beyan etmeniz gerekir. Yetkilendirme kapsamı, Google Workspace uygulamasının adını, eriştiği veri türünü ve erişim düzeyini içeren bir OAuth 2.0 URI dizesidir. Kapsamlar, uygulamanızın kullanıcıların Google Hesabı verileri de dahil olmak üzere Google Workspace verileriyle çalışma istekleridir.
Uygulamanız yüklendiğinde kullanıcıdan uygulama tarafından kullanılan kapsamları doğrulaması istenir. Genel olarak, mümkün olan en dar kapsamı seçmeli ve uygulamanızın gerektirmediği kapsamları istemekten kaçınmalısınız. Kullanıcılar, sınırlı ve açıkça açıklanan kapsamlara daha kolay erişim izni verir.
Yönetici Ayarları API'si aşağıdaki kapsamları destekler:
[null,null,["Son güncelleme tarihi: 2024-11-15 UTC."],[[["This document provides authorization and authentication details specifically for the Admin Settings API within Google Workspace."],["Before using this API, review Google Workspace's general authentication and authorization guidelines."],["Configure OAuth 2.0 including the consent screen and scopes to manage user data access for your app."],["Choose the most restrictive scopes necessary for your application's functionality to foster user trust."],["The Admin Settings API utilizes specific scopes, like `https://apps-apis.google.com/a/feeds/domain/`, to define access levels to domain settings."]]],["To access the Admin Settings API, configure OAuth 2.0 by setting up the consent screen and selecting authorization scopes, which define the level of data access. Scopes are OAuth 2.0 URI strings specifying the Google Workspace app, data type, and access level. Choose the narrowest scopes necessary for your app. Public apps using sensitive data-accessing scopes must undergo a verification process. The Admin Settings API supports one scope: `https://apps-apis.google.com/a/feeds/domain/` for global domain settings access.\n"]]