Farklı kimlik bilgisi türleri ve kapsamlarıyla test etme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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:
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-26 UTC."],[[["\u003cp\u003eThe API Explorer's credentials section allows testing with different credentials (API key or Google OAuth 2.0) and scopes to ensure minimal access requirements.\u003c/p\u003e\n"],["\u003cp\u003eAPI keys are suitable for accessing public data, while OAuth 2.0 credentials are necessary for private data access.\u003c/p\u003e\n"],["\u003cp\u003eUsing the scopes feature, you can select specific access levels (read-only, read-write, etc.) and verify their sufficiency for invoking API methods.\u003c/p\u003e\n"],["\u003cp\u003eTo test with new scopes, you may need to revoke previously approved credentials through your Google account settings.\u003c/p\u003e\n"]]],[],null,["# Test with different credential types and scopes\n\nThe APIs Explorer's credentials section lets you test with different\ncredentials and scopes. This feature is useful in ensuring you're using the\nminimal required credentials and scope to invoke an API endpoint.\n\nTest with different credentials\n-------------------------------\n\nBy default, both the OAuth 2 and API Key credential types are checked.\nIf you want to test with only one credential, check on the credential type to\nuse (and uncheck the other credential type). Following are the general rules for\npicking a credential to test with:\n\n- If you're using a method to access public data, such as Google Maps data, you\n can use an API key as your credential. Check **API key** and uncheck\n **Google OAuth 2.0**.\n\n- If you're using a method to access private data, such as the user's Google\n Drive data, you must use an OAuth 2 credential. Uncheck **API key** and check\n **Google OAuth 2.0**.\n\nIf you receive a result of 200, the credential is sufficient\nfor accessing the data. If you receive a result of 401, you need\nto use OAuth 2 credential to access the data.\n\nTest with different scopes\n--------------------------\n\nA scope is a string, such as\n`https://www.googleapis.com/auth/drive.metadata.readonly`, defining a level of\naccess to resources required by your app, such as the level of access to data\nowned by the users. Ideally, you want your app to use scopes with\nthe narrowest level of access to the user's data. Different methods might\nrequire different scopes. For example, a method in an API might require\nat least a read-only scope, while other methods might require a read-write\nscope.\n| **Note:** Scopes are only applicable to Google OAuth 2.0. If you're testing with an API key, you won't test with different scopes.\n\nBy default, all Google OAuth 2.0 scopes for an API are enabled in the APIs\nExplorer. To test with a specific scope:\n\n1. In the Credentials Google OAuth 2.0 section, click **show scopes**.\n2. Check the scope to use when invoking the method.\n3. Click **Execute** to execute the API using only the selected scope. The APIs Explorer shows an authorization screen asking you to grant access to use the scope.\n4. Click **Allow**. The results appear below the Execute button.\n\nIf the APIs Explorer shows a result of 200 under an \"application/json\", then the\nscope is sufficient to invoke the method. If the APIs Explorer shows an\nresult of 403, you have chosen an insufficient scope to invoke the method. Try\na broader scope.\n\nFor additional information on scope selection, refer to the authentication and\nauthorization section of documentation for your specific Google API.\n\n### Revoke authorized access to test with new scopes\n\nAfter you have used the Google authorization screen to approve authorization,\nthe APIs Explorer remains authorized to make authenticated requests as long\nas the credentials aren't expired. Unchecking scopes doesn't reset the\npreviously approved credentials and scopes. If you want to test with a new\nscope configuration, you must revoke your previously approved credentials.\n\nTo revoke the credentials used by the APIs Explorer:\n\n1. Navigate to [Apps with access to your account](https://www.google.com/accounts/IssuedAuthSubTokens).\n2. Under **Third-party apps with account access** , click **Google APIs Explorer**.\n3. Click **Remove Access**.\n4. (optional) Reload the documentation page to reset the APIs Explorer."]]
