Bu Google OAuth Oyun Alanı Google'ın OAuth 2.0 yetkilendirme akışlarını tek bir satır arka uç kodu yazmadan test etmek için resmi sandbox aracıdır. Bu kılavuz, kapsamları seçme, yetkilendirme kodlarını jetonlarla değiştirme, canlı API çağrıları yapma ve ne zaman oyun alanının ötesine, üretim düzeyinde bir çözüme geçmeniz gerektiğini anlama gibi her özelliği adım adım anlatır.
Google OAuth Alanı Nedir?
Bu Google OAuth Oyun Alanı şu adreste bulunan ücretsiz, tarayıcı tabanlı bir araçtır: developers.google.com/oauthplayground Geliştiricilerin bir arka uç sunucusu kurmadan, uygulama kaydetmeden veya sunucu tarafı kod yazmadan herhangi bir Google API'siyle tam OAuth 2.0 yetkilendirme akışını test etmelerini sağlayan.
Temelinde bu araç, üç aşamalı OAuth 2.0 akışı için görsel bir arayüzdür. Hangi Google API kapsamlarını istediğinizi seçin, "API'leri Yetkilendir" düğmesine tıklayın, Google onay ekranını tamamlayın, ardından ortaya çıkan yetkilendirme kodunu bir erişim belirteci ve bir yenileme belirteci ile değiştirin. Bu noktadan sonra, doğrudan tarayıcı içinden kimliği doğrulanmış API istekleri yapabilir ve ham istek ve yanıt yüklerini inceleyebilirsiniz.
Özellikle Gmail, Google Takvim, Google Drive veya diğer Google Workspace API'lerinin üzerine inşa eden ekipler için kullanışlıdır. Üretimdeki jeton akışlarını hatalardan ayıklamak yerine, her şeyi önce güvenli bir ortamda test edebilirsiniz. Google OAuth 2.0 oyun alanı, yayınlanan her Google OAuth kapsamını destekler ve akışın her adımında tam HTTP üstbilgilerini ve JSON yüklerini gösterir.
Geliştiriciler Neden Google OAuth Devre Alanını Kullanır
OAuth2 oyun alanı, geliştiricilerin dört spesifik sorununu çözer. Hangisinin size uygun olduğunu anlamak, her oturumdan en iyi şekilde yararlanmanıza ve ne zaman bir üretim kurulumuna geçmeniz gerektiğini bilmenize yardımcı olacaktır.
Uygulamanızı göndermeden önce, hangi OAuth kapsamının hangi verilere erişim izni verdiğini tam olarak bilmeniz gerekir. Oyun alanı karşılaştırmanıza olanak tanır gmail.yalnızcaoku vs gmail.değiştir vs gmail.gönder Yan yana, gerçek Gmail API'sini çağırarak ve her bir kapsamın neyi ortaya çıkardığını inceleyerek. Bu, aşırı izin verme (çok fazla kapsam istemek, bu da Google'ın inceleme ekibi tarafından daha fazla incelemeye neden olur) ve yetersiz izin verme (çok az istemek, bu da kullanıcılarınız için çalışma zamanı hatalarına neden olur) durumlarını önler.
Tam bir OAuth yönlendirme akışını yerel olarak kurmak zaman alır: bir HTTP sunucusuna, bir geri çağırma URL'sine, oturum yönetimine ve belirteç depolamaya ihtiyacınız vardır. Oyun alanı bunların hepsini atlar. Tarayıcıda bir kez kimliğinizi doğrular, belirteçlerinizi alır ve ardından "İsteği gönder" panelinden herhangi bir Google API uç noktasını doğrudan çalıştırırsınız. Bu, beklenmeyen 403 hatalarını ayıklamak veya uygulamanızdaki ayrıştırma mantığını yazmadan önce API yanıtlarının yapısını anlamak için özellikle yararlıdır.
Oyun alanı, OAuth 2.0'ın aslında nasıl çalıştığını anlamak için mevcut en iyi öğrenme araçlarından biridir. Adım adım kullanıcı arayüzü, soyut akışı somut hale getirir: seçtiğiniz kapsamlarla yetkilendirme URL'sinin oluşturulduğunu görürsünüz, yönlendirmede döndürülen yetkilendirme kodunu görürsünüz ve bu kodun bir erişim jetonu ve bir yenileme jetonu ile nasıl değiştirildiğini görürsünüz. OAuth'a yeni başlayan mühendisleri işe alan ekipler için oyun alanında yapılacak 30 dakikalık bir oturum, saatlerce dokümantasyon okumayı ortadan kaldırır. Konuyla ilgili rehberimize göz atın: Uygulamanıza Google OAuth 2.0'ı entegre etme tam üretim uygulaması için.
Bazen tek seferlik bir veri taşıma betiği çalıştırmak, bir webhook yükünü test etmek veya bir API entegrasyonunu manuel olarak doğrulamak için geçerli bir erişim belirtecine ihtiyacınız olur. Oyun alanı 60 saniyenin altında çalışan bir erişim belirteci üretir. Kopyalayın, curl komutunuza veya Postman'e yapıştırın ve tamamdır. Dikkat edilmesi gereken nokta, oyun alanı belirteçlerinin (Google'ın varsayılan kimlik bilgilerini kullanarak) süresinin dolmasıdır 24 saat yenileme belirteci için ve erişim belirteci 1 saat sonra sona erer - bu nedenle bu yaklaşım kısa ömürlü komut dosyalarıyla sınırlıdır.
Hızlı Başlangıç: İlk Oyun Alanı Oturumunuzu 3 Dakikada Yapın
Sıfırdan açık alanda çalışan bir API çağrısına ulaşmak için şu beş adımı izleyin. Bu temel akış için Google Cloud Console kurulumu gerekmez.
Açık developers.google.com/oauthplayground tarayıcınızda. Ana arayüzün üç bölüme ayrıldığını göreceksiniz: Adım 1 (API'leri Seçin ve Yetkilendirin), Adım 2 (Yetkilendirme Kodunu Jetonlara Dönüştürün) ve Adım 3 (API'ye İsteği Yapılandırın). Sağ tarafta, dişli simgesi aracılığıyla erişilebilen OAuth 2.0 yapılandırma paneli bulunur. Devam etmeden önce Google hesabınıza giriş yaptığınızdan emin olun.
Adım 1 panelinde, Google API listesinde aşağı kaydırın veya arama kutusunu kullanın. Tıklayın Gmail API v1 Genişletmek için seçin. https://www.googleapis.com/auth/gmail.readonly başlamak için salt okunur erişim. Tek bir oturumda birden çok API'den birden çok kapsam seçebilirsiniz - hepsi tek bir yetkilendirme isteği halinde paketlenecektir. Kapsam(lar)nızı seçtikten sonra, mavi düğmeye tıklayın "API'lere Yetki Ver" düğme.
Google'ın onay ekranına yönlendirileceksiniz. Bu aynı OAuth onay ekranı Üretim uygulamanızda son kullanıcılarınızın göreceği şey şudur: playground yalnızca sizin adınız yerine Google'ın kendi uygulama adını kullanır. Google hesabınızı seçin, istenen izinleri gözden geçirin ve "İzin Ver"e tıklayın. Google sizi URL'de bir yetkilendirme koduyla birlikte playground'a geri yönlendirecektir.
Artık 2. Adım'dasınız. Oyun alanı yetkilendirme kodunu otomatik olarak yakaladı. Tıklayın "Belirteçler için yetkilendirme kodunu değiştir". Oyun alanı bir POST isteği gönderir https://oauth2.googleapis.com/token ve hem ham isteği hem de yanıtı görüntüler. Göreceğiniz şeyler erişim_belirteci (1 saat geçerli) ve sizin yenileme_belirteci Yanıt panelinde. Bunları gerektiğinde not alın.
3. Adımda, "İstek URI" alanına Gmail API uç noktasını girin: https://gmail.googleapis.com/gmail/v1/users/me/messages. HTTP yöntemini olarak bırak GET ve "İsteği Gönder"e tıklayın. Oyun alanı erişim jetonunuzu otomatik olarak Bearer başlığı olarak ekler. Yanıt paneli, Gmail API'sinden gelen JSON yükünü görüntüler - gelen kutunuzdaki mesaj kimliklerinin bir listesini. Oyun alanında tam bir OAuth 2.0 akışını tamamladınız.
Adım Adım: Google OAuth Oyun Alanında OAuth Kapsamlarını Test Etme
Kapsam seçimi, OAuth entegrasyonunuzdaki en önemli karardır. Çok geniş olursa Google'ın inceleme ekibi uygulamanızı işaretler. Çok dar olursa API çağrılarınız 403 hatası döndürür. Ortam, karar vermeden önce her bir kombinasyonu test etmenize olanak tanır. Her Gmail kapsamının tam referansı için bkz. Gmail API Kapsamları kılavuzu.
gmail.yalnızcaoku testten önce gmail.değiştir. Bu en az ayrıcalık ilkesi, uygulamanızın saldırı yüzeyini azaltır ve Google'ın güvenlik incelemesini basitleştirir. İnceleme süreci hakkında daha fazla bilgi: Google OAuth doğrulama kılavuzu.| Kapsam | Erişim Seviyesi | Hassasiyet | Kullanım Örneği |
|---|---|---|---|
gmail.yalnızcaoku |
Tüm mesajları ve ayarları oku | Hassas | E-posta analizi, gelen kutusu senkronizasyonu |
gmail.değiştir |
Okuyun, etiketleri değiştirin, mesajları silin | Kısıtlı | CRM entegrasyonu, triyaj uygulamaları |
gmail.gönder |
Yalnızca mesaj gönder | Kısıtlı | Kullanıcı adına işlem tabanlı gönderme |
gmail.olustur |
Taslakları oluştur, oku, güncelle ve sil | Hassas | Yapay zeka e-posta yardımcıları, taslak yönetimi |
gmail etiketleri |
Etiket oluştur, oku, güncelle ve sil | Hassas | Otomasyon etiketleme, organizasyon araçları |
gmail.metaveri |
Yalnızca mesaj meta verilerini (başlıklar, etiketler) oku | Hassas değil | E-posta varlık göstergeleri, ileti dizisi takibi |
Oyun alanı, Calendar API testi için de aynı şekilde iyi çalışır. Takvim okuma erişimini test etmek için, seçin https://www.googleapis.com/auth/calendar.readonly. Tam okuma/yazma erişimi, etkinlik oluşturma ve silme dahil olmak üzere kullanın https://www.googleapis.com/auth/calendar. Takvim kapsamları da aynı deseni izler: ile başlar salt okunur, ardından yalnızca yazma işlemleri gerekiyorsa yükseltin. Sık yapılan bir hata, tam olanı istemektir takvim sadece müsaitliği okumanız gerektiğinde kapsam - bu gereksiz yere daha invaziv bir güvenlik incelemesini tetikler.
Oyun alanı ayrıca varsayılan menüde listelenmeyen özel kapsam URL'lerini de kabul eder. 1. Adım panelinde, altta bulunan "Kendi kapsamlarınızı girin" alanını arayın. Geçerli herhangi bir kapsam URL'sini - örneğin, bir Google Workspace Yönetici SDK kapsamını veya bir Google People API kapsamını - yapıştırın ve listeden seçtiğiniz kapsamların yanında yetkilendirme isteğine eklenecektir. Bu, oyun alanı kullanıcı arayüzünde öne çıkarılmayan daha az yaygın Google API'lerini test etmek için kullanışlıdır.
Gmail entegrasyonunuzu Unipile ile oluşturunAdım Adım: Erişim Token'ları ve Yenileme Token'ları Oluşturma
Oyun Alanı'nın Adım 2'si, gerçek OAuth büyüsünün gerçekleştiği yerdir. Yetkilendirmeyi yaptıktan sonra, değiştirilmeyi bekleyen bir yetkilendirme kodu oyun alanında bekler. Bu bölüm, geri aldığınız iki jetonu, bir yenileme jetonunu nasıl zorlayacağınızı ve bu değişimi üretim kodunuzda nasıl tekrarlayacağınızı açıklar.
Bu erişim belirteci varsayılan olarak 3600 saniye süren kısa ömürlü bir kimlik bilgisi, Taşıyıcı belirteci olarak kullanılır Authorization Her API isteğinin üstbilgisinde bulunur. Süresi dolduğunda API, 401 hatası döndürür. Kullanıcının yeniden yetki vermesini gerektirmeden yeni bir erişim belirteci almak için yenileme belirtecini kullanırsınız. Oyun alanında, "Erişim belirtecini yenile" düğmesi 2. Adımda bunu otomatik olarak yapar.
Bu yenileme jetonu uzun ömürlü bir kimlik bilgisidir ve uygulamanızın kullanıcı etkileşimi olmadan yeni erişim belirteçleri almasını sağlar. Üretim ortamında asla sona ermez (kullanıcı tarafından iptal edilmediği veya uygulama 6 aydır aktif değilse). Ancak, Google'ın varsayılan kimlik bilgilerini kullanan oyun alanında, yenileme belirteçleri şu süreden sonra süresi dolar: 24 saat. Bu, üretim sınırlaması değil, oyun alanına özgü bir sınırlamadır.
Varsayılan olarak Google, yalnızca bir yenileme jetonu döndürür ilk defa bir kullanıcı uygulamanıza yetki verir. Sonraki yetkilendirmelerde (kullanıcı zaten onaylamışsa), Google yenileme jetonunu atlar. Oyun alanını 2. Adımda her zaman bir yenileme jetonu döndürmeye zorlamak için dişli simgesine tıklayarak OAuth 2.0 yapılandırmasını açın ve her ikisini de etkinleştirin "Zorla istem" ve "Erişim türü: çevrimdışı". Bu ayarlarla, her yetkilendirme akışı yeni bir yenileme jetonu döndürür.
Oyun alanı, yetkilendirme kodunu değiştirmek için gönderdiği tam POST isteğini size gösterir. Bu curl komutunu doğrudan arka ucunuzda çoğaltabilirsiniz:
24 saatlik yenileme jetonu uyarısı: Varsayılan olarak Playground'u kullanırken (en yaygın kurulum), Google, yenileme jetonlarının ömrünü 24 saat ile sınırlar. Bu kasıtlıdır: Playground tek bir paylaşılan OAuth istemcisi kullanır ve Google güvenlik nedeniyle jetonları sık sık geri çeker. 24 saatten daha uzun ömürlü bir yenileme jetonuna ihtiyacınız varsa, Playground ayarlarında "Kendi OAuth kimlik bilgilerinizi kullanın" seçeneğini etkinleştirin - bu bir sonraki bölümde ele alınmıştır.
Google OAuth Alanında Kendi OAuth Kimlik Bilgilerinizi Kullanmak
Varsayılan deneme alanı kurulumu, Google'ın paylaşılan geliştirici kimlik bilgilerini kullanır ve bu da 24 saatlik yenileme belirteci süresinin dolmasına neden olur. Kendi OAuth İstemci Kimliğinize geçmek bunu çözer ve deneme alanının davranışını üretim uygulamanızla aynı hale getirir. Test etmeniz gerektiğinde doğru yaklaşım budur API anahtarı ile OAuth arasındaki farklar veya tümünü tamamla Google OAuth entegrasyon akışı.
https://developers.google.com/oauthplayground. Bu, oyun alanının beklediği belirli yönlendirme URI'sidir.gmail.değiştir) doğrulanmış bir uygulama gerektirir. Kendi kimlik bilgilerinizle, tam doğrulama işlemine gerek kalmadan 100'e kadar test kullanıcısıyla geliştirme modunda test yapabilirsiniz.client_id, client_secretve yönlendirme_url'si Üretim arka ucunuzda kullanacaksınız. Anahtar kodunu doğrudan uygulamanıza kopyalayabilirsiniz.https://developers.google.com/oauthplayground/ ancak oyun alanı, sondaki eğik çizgi olmadan URL'ye yönlendirir, bir alacaksınız yeniden_yönlendirme_urf_eşleşmiyor Hata. Emin değilseniz her iki sürümü de ekleyin. Google'ın hata kodlarına daha yakından bakmak için kılavuzumuza bakın. Yaygın Google OAuth Hataları.Yaygın Google OAuth Playground Hataları
Bunlar, geliştiricilerin playground'da en çok takıldığı altı hata ve yanıltıcı noktadır. Her birinin uygulaması 2 dakikadan az süren belirli bir çözümü vardır.
Google'ın varsayılan playground kimlik bilgilerini kullandığınızda, yenileme belirteciniz 24 saat sonra geçersiz hale gelir. Bu belirtece dayanan herhangi bir betik veya entegrasyon şunu döndürmeye başlayacaktır 401 geçersiz_verilen ertesi gün hatalar.
Kendi kimlik bilgilerinizi kullandığınızda, Google şunu döndürür hata=yeniden_yönlendirme_urisi_eşleşmiyor Yetkilendirme adımı sırasında. Bu, Cloud Console OAuth istemcinizdeki yönlendirme URI'sinin, oyun alanının gönderdiğiyle tam olarak eşleşmediği anlamına gelir.
https://developers.google.com/oauthplayground yetkilendirilmiş bir yönlendirme URI'si olarak (sonda eğik çizgi olmadan). kılavuzumuza bakın OAuth hataları daha fazla.3. Adımdaki API çağrısı şunları döndürür 403 Yetki Yetersizliği. Bu, Adım 1"de dahil etmediğiniz bir kapsam gerektiren bir uç noktayı çağırdığınızda veya yeni bir kapsam ekledikten sonra "API'leri Yetkilendir" düğmesine tıklamayı unuttuğunuzda gerçekleşir.
Erişim belirteçleri yalnızca 3600 saniye geçerlidir. Test oturumunuz uzun sürerse, 3. Adımdaki çağrılar geri dönmeye başlayacaktır. 401 Geçersiz Kimlik Bilgileri yenileme belirteciniz hala geçerli olsa bile.
Bazı Google API'lerinin sürümlü kapsam gereksinimleri vardır. Örneğin, Google Takvim API v3, eski sürümlerden farklı temel URL'ler kullanır. v3 uç noktası üzerinde v1 için tasarlanmış bir kapsam kullanmak beklenmeyen hatalara veya eksik verilere neden olabilir.
Şirket proxy'leri, VPN'ler gibi belirli ağ ortamlarından oyun alanının "İsteği gönder" özelliğini kullandığınızda Geliştirici Araçları'nda CORS ile ilgili hatalar görüyorsunuz. Bu, Google API sorunu değil, oyun alanına özgü bir tarayıcı davranışıdır.
Oyun Alanı vs. Üretim: Google OAuth Oyun Alanı'nın Yetersiz Kaldığı Durumlar
Test ortamı, üretimde kullanıma uygun olmayan mükemmel bir test aracıdır. İşte test ortamından gerçek kullanıcıları hizmet veren gerçek bir OAuth entegrasyonuna geçtiğinizde nelerin değiştiğinin dürüst bir karşılaştırması.
| Özellik | OAuth Oyun Alanı | Üretim Uygulaması |
|---|---|---|
| Yenileme jetonu ömrü | 24 saat maksimum (Google kimlik bilgileriyle) Kendi kimlik bilgileriyle sınırsız |
Sınırsız kullanıcı iptal edene veya 6 ay işlem yapılmayana kadar |
| Kullanıcı tabanı | 1 kullanıcı (yalnızca Google hesabınız) | N kullanıcı - herhangi sayıda Google hesabı uygulamanızı yetkilendirebilir |
| OAuth doğrulama | Gerekli değil - oyun alanı incelemeleri atlar | Gerekli 100 test kullanıcısından sonra, kısıtlı kapsamlar için |
| CASA Seviye 2 güvenlik incelemesi | Uygulanamaz - oyun alanı Google'ın kendi aracıdır | Kısıtlanmış Gmail veya Takvim kapsamlarını isteyen uygulamalar için gereklidir |
| Onay ekranı markalaması | Uygulama adı olarak "Google OAuth 2.0 Playground" gösteriliyor. | Uygulamanızın adını, logosunu ve gizlilik politikasını gösterir |
| İstek / yanıt görünürlüğü | Tam görünürlük - tüm HTTP başlıklarını ve yükünü gör | Son kullanıcılardan gizlenir - yalnızca arka ucunuz ham belirteçleri ve API yanıtlarını görür |
| API hız sınırları | Standart Google API kotaları (Google'ın kimlik bilgilerini kullanırken diğer oyun alanı kullanıcılarıyla paylaşılır) | Kendi projenize özel kota - diğer geliştiricilerle paylaşılmaz |
| Kullanım amacı | Test etme, hata ayıklama, öğrenme, tek seferlik jeton oluşturma | Kullanıcılara ölçekte kalıcı, çok kullanıcılı belirteç yönetimi ile hizmet verme |
Pratik kural: Entegrasyon mantığınız onaylanana kadar playground'u kullanın, ardından kullanıcıya açık her şey için üretim OAuth akışına geçin. Üretimde en büyük zorluk noktası Google'ın doğrulama süreci; hassas veya kısıtlı kapsamları talep eden uygulamalar için bu haftalar sürebilir. Unipile gibi bir çözümün yardımcı olabileceği yer burasıdır: önceden doğrulanmış kimlik bilgileri kullanın ve ürün-pazar uyumunu doğrularken incelemeyi tamamen atlayın. Tam kılavuzumuzu şu adreste görün: OAuth e-posta API entegrasyonu üretim kalıplarına derinlemesine bir bakış için.
Haftalarca süren doğrulama.
Kullanım Unipile anahtarı ve şimdi başla.
Oyun alanında test ettiniz - şimdi 6 aylık Google doğrulama beklemesi olmadan yayına geçin. Önceden doğrulanmış geliştirici kimlik bilgilerimizle Gmail hesaplarını 5 dakikada bağlayın.
Google OAuth Oyun Alanından Üretime: Doğrulama Beklemesini Atla
Oyun alanı entegrasyon mantığınızın çalıştığını doğruladı. Bir sonraki adım, üretim ortamındaki gerçek kullanıcı hesaplarını bağlamaktır. Ancak sorun şu: Hassas veya kısıtlı Gmail kapsamlarını isteyen uygulamalar için Google'ın OAuth doğrulama süreci 4 ila 12 hafta, ve kısıtlı kapsamlar için CASA Seviye 2 güvenlik denetimi gerektirir gmail.değiştir ve gmail.gönder.
Unipile, önceden doğrulanmış Google OAuth kimlik bilgileriyle bunu çözüyor. Google'ın uygulamanızı onaylamasını aylar boyunca beklemek yerine, şunu kullanırsınız: Unipile'ın CASA Seviye 2 Sertifikalı geliştirici anahtarı Gmail hesaplarını anında bağlamak için. Kullanıcılarınız Google'ın standart onay ekranından yetki verir, uygulamanız Unipile'ın API'si aracılığıyla e-postaları okur ve gönderir ve hazır olduğunuzda istediğiniz zaman kendi doğrulanmış kimlik bilgilerinize geçiş yapabilirsiniz. Bu, ekibimizin üzerine inşa ettiği ekipler tarafından kullanılan yaklaşımdır. Google OAuth entegrasyonu ve daha geniş anlamda E-posta API platformu.
Google OAuth Playground - SSS
Test, token, kapsam ve alandan üretime geçiş hakkında en sık sorulan soruların yanıtları.
Bu Google OAuth Oyun Alanı şu adreste bulunan ücretsiz, tarayıcı tabanlı bir araçtır: developers.google.com/oauthplayground Bu, geliştiricilerin herhangi bir Google API'sine karşı OAuth 2.0 yetkilendirme akışlarını test etmelerini sağlar. Arka uç kodu yazmadan kapsamları seçin, Google hesabınızı yetkilendirin, yetkilendirme kodunu jetonlarla değiştirin ve canlı API çağrıları yapın. Google tarafından yönetilir, yayınlanan her Google API kapsamını destekler.
Erişim belirteçleri 1 saat (3600 saniye) sonra geçerli. Yenileme belirteçleri Google'ın varsayılan oyun alanı kimlik bilgileri 24 saat sonra süresi doluyor - bu oyun alanına özgü bir sınırlamadır. Oyun alanını kendi OAuth kimlik bilgilerinizi (Google Cloud Console'dan Alınan İstemci Kimliği ve İstemci Gizli Anahtarı) kullanacak şekilde yapılandırırsanız, yenileme jetonları üretim jetonları gibi davranır ve 24 saatlik bir süre bitimi olmaz. Yetkilendirme yapmadan yeni bir erişim jetonu almak için Adım 2"de istediğiniz zaman "Erişim jetonunu yenile" düğmesine de tıklayabilirsiniz.
Hayır. Oyun alanı bir yalnızca test ve hata ayıklama aracı. Kendi kullanıcı hesabınızla sınırlıdır, varsayılan kimlik bilgileriyle belirteçler çabuk sona erer ve üretim uygulamalarında gerekli olan çoklu kullanıcı yetkilendirme akışlarını desteklemez. Üretim için kendi OAuth uygulamanızı kaydetmeniz, arka ucunuzda yetkilendirme yönlendirme akışını uygulamanız ve hassas kapsamlar için şunları yapmanız gerekir: gmail.değiştir, Google'ın doğrulama işlemini tamamlayın. Alternatif olarak, ... gibi bir hizmet kullanın Unipile'ın önceden doğrulanmış OAuth kimlik bilgileri daha hızlı sevkiyat yapmak için.
Google Cloud Console'da bir OAuth 2.0 Web uygulaması kimlik bilgisi oluşturun ve ekleyin. https://developers.google.com/oauthplayground Yetkili bir yönlendirme URI'si olarak. İstemci Kimliğini ve İstemci Sırrını kopyalayın. Oyun alanında, üzerine tıklayın dişli simgesi, "Kendi OAuth kimlik bilgilerinizi kullanın" seçeneğini etkinleştirin ve İstemci Kimliğinizi ve İstemci Gizli Anahtarınızı yapıştırın. "Kapat" seçeneğine tıklayın, ardından normal şekilde Adım 1 kapsamı seçimi ve yetkilendirmesiyle devam edin. Tokenlarınız artık üretim eşdeğeri ömürlere sahip olacaktır.
24 saatlik geçerlilik süresi, çünkü siz kullanıyorsunuz oyun alanının varsayılan paylaşılan kimlik bilgileri (Google'ın kendi OAuth istemcisi). Google, güvenlik nedenleriyle bu paylaşılan belirteçleri kasıtlı olarak sınırlar. Üretim OAuth belirteçleri bu şekilde çalışmaz. Çözüm, oyun alanı dişli ayarlarında "Kendi OAuth kimlik bilgilerinizi kullanın" seçeneğini etkinleştirmek ve kendi İstemci Kimliğinizi ve İstemci Sırrınızı sağlamaktır. Kendi kimlik bilgilerinizle, yenileme belirteçleri kullanıcı erişimi açıkça iptal edene veya uygulama 6 ay boyunca etkin değilse geçerlidir.
Evet, tamamen. Oyun alanı Adım 1'de, genişletin "Gmail API v1" ve herhangi bir Gmail kapsamını seçin (gmail.yalnızcaoku, gmail.değiştir, gmail.gönder, vb.). Yetkilendirme sonrasında, 3. Adım'da uç nokta URL'sini girin, örneğin https://gmail.googleapis.com/gmail/v1/users/me/messages ve "İsteği gönder" düğmesine tıklayın. Gmail gelen kutunuzdan canlı yanıtı göreceksiniz. Gmail kapsamları ve izinlerinin tam bir referansı için lütfen Gmail API Kapsamları kılavuzu.
Oyun alanı, yayınlanan tüm Google API kapsamlarını destekler. Dahili liste Gmail API, Google Takvim, Google Drive, Google E-tablolar, Google Dokümanlar, Google Slaytlar, Google Yönetici SDK'sı, Google Kişiler API'si, Google Görevler, YouTube ve daha birçoklarını içerir. Kapsam URL'sini "Kendi kapsamlarınızı girin" alanına manuel olarak girerek özel bir kapsamı da test edebilirsiniz. Farklı API'lerden birden fazla kapsam tek bir yetkilendirme isteğinde birleştirilebilir.
Bu hata yalnızca kendi OAuth kimlik bilgilerinizi kullandığınızda ortaya çıkar. Gidin Google Cloud Console, OAuth istemcinizin ayarlarını açın ve ekleyin https://developers.google.com/oauthplayground (sondaki eğik çizgi olmadan) yetkili bir yönlendirme URI'si olarak. Kaydedin, değişikliklerin yayılmasını beklemek için birkaç dakika bekleyin, ardından tekrar deneyin. Hata devam ederse, eğik çizgi sonundaki sürümü de eklemeyi deneyin. Daha fazla OAuth hatası çözümü için şunları inceleyin Google OAuth Hataları Kılavuzu.
Evet, Google OAuth Playground tamamen ücretsiz. oyun alanı arayüzünü kullanmak için herhangi bir hesap gerekmez - sadece gidin developers.google.com/oauthplayground ve herhangi bir Google hesabıyla oturum açın. Playground aracılığıyla yaptığınız API çağrıları Google Cloud projenizin kota limitine dahil edilir (çoğu API için cömert bir ücretsiz kullanım seviyesi bulunur), ancak playground aracının kendisinin bir maliyeti yoktur. Tamamen yönetilen bir alternatif için şuraya bakın: Unipile'un üretime hazır Gmail API'si.
Çoklu son kullanıcılar için Gmail veya Google Takvim hesaplarını bağlayan SaaS uygulamaları için, Unipile Kısıtlı kapsamlar için 4-12 haftalık Google doğrulama süreci yerine, kullanıcı Gmail hesaplarını anında bağlayabilirsiniz. Ayrıca, üretim düzeyinde, önceden doğrulanmış Google kimlik bilgileriyle (CASA Tier 2 Sertifikalı, SOC 2, GDPR uyumlu) bir OAuth API'si sunar. Unipile Google OAuth belgelerini oku Tam API çağrılarını görmek için. Kesinti yaşamadan istediğiniz zaman kendi doğrulanmış kimlik bilgilerinize geçiş yapın.
Google OAuth veya alan hakkında hâlâ sorularınız mı var?