API Gezgini'nin kimlik bilgileri bölümü, farklı kimlik bilgileri ve kapsamlarla test yapmanıza olanak tanır. Bu özellik, bir API uç noktasını çağırmak için gereken minimum kimlik bilgilerini ve kapsamı kullandığınızdan emin olmanıza yardımcı olur.
Farklı kimlik bilgileriyle test etme
Varsayılan olarak hem OAuth 2 hem de API anahtarı kimlik bilgisi türleri işaretlenir. Yalnızca bir kimlik bilgisiyle test yapmak istiyorsanız kullanılacak kimlik bilgisi türünü işaretleyin (diğer kimlik bilgisi türünün işaretini kaldırın). Aşağıda, test etmek için kimlik bilgisi seçmeyle ilgili genel kurallar verilmiştir:
Herkese açık verilere (ör. Google Haritalar verileri) erişmek için bir yöntem kullanıyorsanız kimlik bilgisi olarak API anahtarı kullanabilirsiniz. API anahtarı'nı işaretleyin ve Google OAuth 2.0'ın işaretini kaldırın.
Kullanıcının Google Drive verileri gibi özel verilere erişmek için bir yöntem kullanıyorsanız OAuth 2 kimlik bilgisi kullanmanız gerekir. API anahtarı'nın işaretini kaldırın ve Google OAuth 2.0'ı işaretleyin.
200 sonucu alırsanız kimlik bilgisi, verilere erişmek için yeterlidir. 401 sonucu alırsanız verilere erişmek için OAuth 2 kimlik bilgisi kullanmanız gerekir.
Farklı kapsamlarla test etme
Kapsam, uygulamanızın ihtiyaç duyduğu kaynaklara erişim düzeyini tanımlayan bir dizedir (ör. https://www.googleapis.com/auth/drive.metadata.readonly). Bu kaynaklar arasında, kullanıcıların sahip olduğu verilere erişim düzeyi de yer alır. İdeal olarak, uygulamanızın kullanıcı verilerine en dar düzeyde erişim sağlayan kapsamları kullanmasını istersiniz. Farklı yöntemler farklı kapsamlar gerektirebilir. Örneğin, bir API'deki bir yöntem için en az salt okuma kapsamı gerekirken diğer yöntemler için okuma/yazma kapsamı gerekebilir.
Bir API için tüm Google OAuth 2.0 kapsamları, varsayılan olarak API'ler Explorer'da etkindir. Belirli bir kapsamla test etmek için:
- Credentials Google OAuth 2.0 (Kimlik Bilgileri Google OAuth 2.0) bölümünde show scopes'u (kapsamları göster) tıklayın.
- Yöntemi çağırırken kullanılacak kapsamı kontrol edin.
- API'yi yalnızca seçilen kapsamı kullanarak yürütmek için Execute'u (Yürüt) tıklayın. API Gezgini, kapsamı kullanmak için erişim izni vermenizi isteyen bir yetkilendirme ekranı gösterir.
- İzin ver'i tıklayın. Sonuçlar, Çalıştır düğmesinin altında görünür.
API Gezgini, "application/json" altında 200 sonucu gösteriyorsa kapsam, yöntemi çağırmak için yeterlidir. API Gezgini 403 sonucu gösteriyorsa yöntemi çağırmak için yetersiz kapsam seçmişsinizdir. Daha geniş bir kapsamı deneyin.
Kapsam seçimi hakkında daha fazla bilgi için belirli Google API'nize yönelik dokümanların kimlik doğrulama ve yetkilendirme bölümüne bakın.
Yeni kapsamlarla test etmek için yetkili erişimi iptal etme
Google yetkilendirme ekranını kullanarak yetkilendirmeyi onayladıktan sonra, kimlik bilgilerinin süresi dolmadığı sürece API Gezgini, kimliği doğrulanmış istekler yapmaya yetkili kalır. Kapsamların işareti kaldırıldığında, daha önce onaylanan kimlik bilgileri ve kapsamlar sıfırlanmaz. Yeni bir kapsam yapılandırmasıyla test etmek istiyorsanız daha önce onaylanmış kimlik bilgilerinizi iptal etmeniz gerekir.
API Gezgini tarafından kullanılan kimlik bilgilerini iptal etmek için:
- Hesabınıza erişimi olan uygulamalar bölümüne gidin.
- Hesap erişimi olan üçüncü taraf uygulamaları bölümünde Google API Gezgini'ni tıklayın.
- Erişimi kaldır'ı tıklayın.
- (İsteğe bağlı) API Gezgini'ni sıfırlamak için doküman sayfasını yeniden yükleyin.