Gmail API Entegrasyonu Artık Çok Kolay: Kapsamlı Bir Kılavuz.

Kaydolun Google Developers Console ve yeni bir proje oluşturun ya da mevcut bir Google projesini kullanın.

Google Developers Console'da 'Kimlik Bilgileri' bölümüne gidin.
Etkin API'lerinize erişim sağlamak için 'OAuth İstemci Kimliği' kimlik bilgilerini oluşturun:
Uygulama türü: Web uygulaması
İsim: Dahili adınız
2 Yetkili yönlendirme URI'si ekleyin:
https://{{YOUR_DSN}}/api/v1/hosted/google_auth_request_callback (DSN'nizi sayfanın sağ üst köşesinde bulabilirsiniz. Unipile Gösterge Tablosu, örnek https://api1.unipile.com:13211/api/v1/hosted/google_auth_request_callback
https://{{YOUR_DSN less port}}/api/v1/hosted/google_auth_request_callback/port{{YOUR_DSN less domain}} (DSN'nizi Unipile Dashboard'un sağ üst köşesinde bulabilirsiniz, örnek https://api1.unipile.com/api/v1/hosted/google_auth_request_callback/port13211

"OLUŞTUR "a tıklayın
Unipile Dashboard > Ayarlar > Google OAuth'a Müşteri Kimliği ve Müşteri Sırrı ekleyin

Google Developers Console'daki 'Kitaplık' bölümüne gidin.
Gerekli API Kütüphanelerini Etkinleştirin:
Uygulamanızın ihtiyaç duyacağı tüm API Kütüphanelerini arayın ve etkinleştirin: Gmail API

Uygulama boyunca Google Projenizi farklı durumlarda tutabilirsiniz:

'Kullanıcı Türü'nü 'Dahili' olarak ayarlayın: Bu modda, uygulamanız kuruluşunuzdaki Google Workspace kullanıcılarıyla sınırlıdır.
'Kullanıcı Türü' 'Harici' olarak ve 'Yayınlama Durumu' 'Test Ediliyor' olarak ayarlanmıştır:
Not: 'Test Aşamasındayken' Test Kullanıcıları eklemeniz gerekir. Belirteçlerin süresi 7 gün içinde dolar ve kullanıcıların yeniden kimlik doğrulaması yapmasını gerektirir.
Yayın Durumu hakkında daha fazla bilgi için buraya tıklayın.
Kullanıcı Tipleri hakkında ayrıntılar için, buraya tıklayın.

Projenizin test ve dağıtım aşamasına göre uygun Kullanıcı Türünü ve Yayınlama Durumunu seçtiğinizden emin olun.

Google Developers Console'daki 'Etkin APIS ve Hizmetler' bölümüne erişin.
Etkin API'leri kontrol edin: Google Projenizde etkinleştirdiğiniz API'lerin tam listesini inceleyin ve doğrulayın.
Gösterge Paneli, etkinleştirilmiş tüm API'lere genel bir bakış sağlayarak projeniz için seçtiğiniz API'lerin durumunu onaylamanıza olanak tanır. Uygulamanızla sorunsuz bir entegrasyon için gerekli API'lerin etkinleştirildiğinden emin olmak için bu bölümü kullanın.

Aşağıdaki bilgilerin sağlandığından emin olun:

Uygulama Adınızı Girin: Uygulama adınızı belirtin.
Kullanıcı Destek E-postası: Kullanıcıların onaylarıyla ilgili soruları için iletişime geçebilecekleri bir e-posta adresi ekleyin. İlgili tarafların dahil olduğu bir takma ad veya dağıtım listesi kullanmanızı öneririz.
Uygulama Logonuzu Ekleyin: Görsel tanımlama için uygulama logonuzu yükleyin.

OAuth onay ekranı bölümünde bu bilgilerin tamamlanması, kullanıcıların onay sürecinde uygulamanızı anlaması ve güvenmesi için çok önemlidir. Sorunsuz bir kullanıcı deneyimi için doğru ayrıntıları ve marka öğelerini ekleyin.

App Domain bölümü altında aşağıdaki bilgileri sağlayın:

Uygulama Ana Sayfası URL'si: Uygulamanızın ana sayfasının URL'sini ekleyin.
Bunun gerçek bir ana sayfa olduğundan ve sadece bir 'giriş' sayfası olmadığından emin olun.
Uygulama Gizlilik Politikası Bağlantısı: Uygulamanızın Gizlilik Politikasına bir bağlantı ekleyin.
Önemli: Hukuk ekibinizin Gizlilik Politikasını incelediğinden emin olun Google'ın özel gereksinimleriözellikle de verilen belgenin 'Sınırlı Kullanım' bölümünden.
Uygulama Hizmet Şartları Bağlantısı: Uygulamanızın Hizmet Şartları'na bir bağlantı ekleyin.

Yetkili etki alanları eklemek için aşağıdaki adımları izleyin:

• Google Projenizde kullanılan uygulama alan adınızı ekleyin. Etki alanınızın dev/staging etki alanı değil, üretim düzeyi etki alanı olduğundan emin olun.
• unipile.com alan adı ekle

• Bir E-posta Adresi Girin:
  • Geliştirici iletişim bilgileri için bir e-posta adresi sağlayın.
  • Önemli: Bu, ilgili tüm tarafların Google Doğrulama ile ilgili e-postaları ve projenizdeki herhangi bir değişiklikle ilgili bildirimleri almasını sağlayan bir dağıtım listesi e-posta adresi olmalıdır. Ekip üyeleri gelip gittikçe bu dağıtım listesini güncel tutun.
• Doğrulama Sonrası İzleme:
  • Doğrulama için gönderildikten sonra, Google'dan gelen herhangi bir eylem öğesi için Google projesini yakından izleyin.
  • Not: Google bu adrese e-posta gönderir, ancak bunlar spam klasörlerine düşebilir veya sunucular tarafından engellenebilir. Önemli iletişimleri kaçırmamak için güncellemeleri düzenli olarak kontrol edin.

Google projenizin durumu ve doğrulama sonrası gerekli işlemler hakkında bilgi sahibi olmak için aktif olarak izlenen ve düzenli olarak kontrol edilen bir e-posta adresi girdiğinizden emin olun.

• Menüye erişmek için 'KAPSAM EKLE VEYA KALDIR' düğmesine tıklayın.
• Aşağıdaki kapsamları ekleyin (listede görünmezlerse sayfayı yenileyin) :
  ./auth/gmail.send
  ./auth/gmail.labels
  ./auth/gmail.readonly
  ./auth/gmail.modify (e-posta taşımak veya silmek istemiyorsanız gerekli değildir. Google'a bunu gerçekten kullandığınızı göstermeniz gerekecek. Unipile hesabınızdan manuel olarak kaldırmak için bizi bilgilendirin)

Bu adıma ancak entegrasyonunuz tamamen tamamlandıktan ve üretimde çalışır hale geldikten sonra devam edebilirsiniz.

Google'ın şartlarına uygun bir tanıtım videosu hazırlayın ve sunun. Uygulamanızı Google'da doğrulamak için uygulamanızın işlevselliğini gösteren bir video da göndermeniz gerekir. Bu video, doğrulama amacıyla 'Listelenmemiş' bir YouTube videosu olarak yüklenmelidir ve yalnızca bir video bağlantısına izin verilir.

• Uygulamanız ve OAuth akışınız, Google belgelerinde "Hassas kapsamlar talep eden uygulamalar" ve "Kısıtlı kapsamlar talep eden uygulamalar" altında belirtildiği gibi İngilizce olarak sunulur.
• Gösterim, üretim düzeyinde bir etki alanında gerçekleştirilmiştir.
• Google Project ayarlarınızda Gezinti Menüsü -> API'ler ve Hizmetler -> OAuth Onay Ekranı'na gidin ve aşağıdakileri onaylayın:
  • Yayınlama durumu "Üretimde" olarak ayarlanmıştır.
  • Kullanıcı Türü "Harici" olarak belirlenmiştir.

• Uygulamanızın ana sayfasını, üretim durumunu vurgulayarak tam URL ile görüntüleyin.
• Resmi Google oturum açma düğmesinin kullanımını vurgulayarak bir Google müşterisinin hesabına nasıl bağlanabileceğini gösterin.
• Kimlik doğrulama akışı sırasında, OAuth işlemi ekranını sunarken, URL'yi vurgulayın ve URL'deki MÜŞTERİ KİMLİĞİNİ ortaya çıkarmak için sürükleyin.

• Talep edilen her bir kapsam setini, özel kullanım durumunuza göre uyarlayarak sırayla sergileyin.
• Uygulamanız ve Gmail arasındaki senkronizasyonu göstererek çift yönlü işlevselliği gösterin. Uygulamanız ve Gmail'in ilgili her bölümü arasında geçiş yapmak için ayrı sekmeler kullanın. Örneğin, uygulamanız üzerinden bir e-posta göndererek, değişikliklerin Gmail'deki Gönderilmiş posta listesinde nasıl senkronize edildiğini gösterin ve diğer şekilde uygulamanızda gelen bir e-postanın alındığını görüntüleyin.

Bu yönergeleri izleyerek, demo videonuz kimlik doğrulama sürecini ve uygulamanızın işlevsel özelliklerini Google hizmetleriyle senkronize bir şekilde etkili bir şekilde aktaracaktır.

Video demonuzu oluşturduktan ve belirtilen tüm kriterlere uygun olduğundan emin olduktan sonra, lütfen YouTube video URL'sini bizimle paylaşın. İnceleme sürecinde yardımcı olabiliriz veya uygulamanızı doğrudan doğrulama için göndermeye devam edebilirsiniz.

Lütfen aşağıdaki adımlara dikkat edin:

• Son videoyu Google Projenize 'listelenmemiş' bir YouTube video bağlantısı olarak ekleyin.
• YouTube video URL'sini incelenmesi için Müşteri Başarı Yöneticinize gönderin.
• İncelemenin ardından, uygulama doğrulama gönderimi ile devam edin.

Doğrulama sürecinin süresinin değişebileceğini unutmayın. Gönderimin ardından, Google'ın gönderim kuyruğuna ve gerekli gördüğü düzeltme turlarının sayısına bağlı olarak 2 ila 8 hafta sürebilir. Doğrulama süreci boyunca bilgi sahibi olun ve bizimle koordinasyon halinde olun.

Uygulamanız kısıtlı kapsamlar kullanıyorsa, ek adımlar gerekir. Burada ne beklemeniz gerektiğine dair kısa bir genel bakış bulunmaktadır:

Google Güvenlik Değerlendirmesi
Kullanıcı verilerinin güvenliğini sağlamak için, kısıtlı kapsamdaki Google kullanıcı verilerine erişim talep eden uygulamaların bir güvenlik değerlendirmesinden geçmesi gerekir. Bu değerlendirme, Google kullanıcı verilerine erişen tüm uygulamaların verileri güvenli bir şekilde işleyebildiğini ve talep üzerine kullanıcı verilerini silebildiğini doğrulamak için çok önemlidir. Ayrıntılı değerlendirme süreci CASA (Bulut Uygulaması Güvenlik Değerlendirmesi) sitesinde özetlenmiştir.

Google uygulamanızı Kademe 2 veya Kademe 3 olarak kategorize eder

Kademe 2 (Kendi Kendine Taranan - Laboratuvar Onaylı) >> En Yaygın
Ücretsiz VEYA ücretli (üçüncü taraf değerlendirici) seçeneği
CASA Kademe 2 Süreci
Kademe 3 (Laboratuvar Taramalı - Laboratuvar Onaylı)
Ücretli - Üçüncü taraf bir değerlendirici tarafından tamamlanmalıdır
Kademe sınıflandırmanızı aldıktan sonra Google, değerlendirmeyi tamamlamanız için talimatlar ve araçlar sağlayacaktır. Google Güvenlik Değerlendirmesi Bilgileri için sağlanan bağlantıya bakın ve daha ayrıntılı bilgi için Güvenlik Değerlendirmesi SSS bölümüne ilerleyin. Uygulamanızın kısıtlı kapsamları kullanırken kullanıcı verilerini güvenli bir şekilde işleme kapasitesini göstermek için bu sürece uyduğunuzdan emin olun.

Google Güvenlik Değerlendirme Bilgileri

Kısıtlı Kapsamlara Sahip Uygulamalar için Yıllık Güvenlik Yeniden Değerlendirmesi
Kısıtlı kapsamlara erişen uygulamalar, uyumluluk için yıllık yeniden doğrulama sürecinden geçmeli ve doğrulanmış kısıtlı kapsamlara erişimi sürdürmek için her 12 ayda bir güvenlik değerlendirmesini tamamlamalıdır. Bu süreç, güvenlik standartlarına sürekli uyulmasını sağlar ve kullanıcı verilerini korur.

Herhangi bir noktada, daha önce değerlendirilmemiş ve onaylanmamış yeni bir kısıtlı kapsam sunarsanız, uygulamanızın o zaman yeniden değerlendirilmesi gerekebilir.

Google inceleme ekibi, uygulamanızın yeniden onaylanma zamanı geldiğinde e-posta yoluyla iletişim başlatacaktır. Proje Sahibi ve Proje Editörü bilgilerinizi Cloud Console'da güncel tutmanız çok önemlidir. Bu, ekibinizin doğru üyelerinin bu yıllık uygulama hakkında bildirimler almasını sağlayarak yeniden değerlendirme gerekliliklerine zamanında ve sorunsuz bir şekilde uyulmasına olanak tanır. Uygulamanızın güvenliğini ve uyumluluğunu korumak için tetikte olun ve Google'dan gelen iletişimlere derhal yanıt verin. Daha fazla bilgi için Google SSS bölümüne göz atın.

Beyaz Liste Seçeneği
Standart doğrulama ve güvenlik incelemesi süreçlerine bir alternatif tercih ediyorsanız, başvurunuzun beyaz listeye alınması seçeneğine sahipsiniz. Bu, olağan prosedürleri atlamanıza olanak tanır, ancak bu seçeneğin yalnızca uygulamanızın çok özel kriterleri karşılaması durumunda geçerli olduğunu unutmamak önemlidir. Çoğu kullanım durumu bu kriterleri karşılamasa da, beyaz listeye alınmanın uygulamanız için uygun olup olmadığını değerlendirebilmeniz için aşağıdaki gereksinimleri özetledik.

Gereksinimler:

Müşterilerin çoğunluğu Google Workspace kullanıyor:
Müşterilerinizin çoğunluğu Google Workspace (eski adıyla GSuite) hesaplarını kullanmalıdır, yani @company.com biçiminde e-posta adreslerine sahip olmalıdır.
Beyaz liste, erişime izin vermek için son kullanıcıların yöneticilerinin harekete geçmesini gerektirir. Kullanıcılarınızın yöneticilerine Google projet Müşteri Kimliğinizi sağlamanız gerekir. Konsollarını açtılar: https://admin.google.com/ac/owl/list?tab=configuredApps ve size client_id izni verdiler.
Sınırlı Kişisel Gmail Hesabı Kullanımı:
100'den az kişisel Gmail hesabı (@gmail.com adresleri) bu akışta kimlik doğrulaması yapabilmelidir.
Doğrulanmamış projelerde proje başına 100 (ömür boyu) kullanıcı sınırı vardır. Beyaz listeye alındığında, Google Workspace hesapları bu sınıra dahil edilmez. Ancak, kişisel Gmail hesapları her zaman bu sınıra dahil edilir.
Ücretsiz Deneme Kullanıcıları ve Beyaz Liste:
Ücretsiz deneme kullanıcıları Workspace e-posta adreslerini kullanmalı ve uygulamayı beyaz listeye eklemelidir.
Beyaz listenin geçici bir çözüm olduğunu ve tüm kullanım durumları için uygun olmayabileceğini unutmayın. Uygulamanızın beyaz liste kriterlerine uyup uymadığını belirlemek için bu gereksinimleri dikkatlice değerlendirin. Eğer öyleyse, bu gereksinimleri karşılamak için gerekli adımları atın ve bu alternatif yaklaşımı keşfedin.

Gmail API'si özellikle Gmail hesaplarıyla etkileşim için tasarlanmıştır ve diğer e-posta istemcileri veya hizmetleriyle doğrudan entegre olmaz. Ancak geliştiriciler, e-postaları Gmail'e veya Gmail'den senkronize etmek veya geçirmek için API'yi kullanabilir ve ardından Gmail dışındaki istemcilerle etkileşimleri kendi API'leri veya IMAP veya SMTP gibi protokoller aracılığıyla gerçekleştirebilir.

Gmail API, Google'ın katı gizlilik politikalarına ve GDPR gibi düzenlemelere uyumluluğa bağlıdır. Kullanıcı onayı zorunludur ve uygulamaların kimlik doğrulama ve yetkilendirme için OAuth 2.0 kullanması gerekir; böylece kullanıcıların Gmail hesaplarına erişim için açıkça izin vermeleri sağlanır. Uygulamanın erişim kapsamı, işlevsellik için gerekli olanla sınırlıdır ve kullanıcılar istedikleri zaman erişimi iptal edebilir.

Gmail API'sini kullanmanın maliyeti, uygulamanız aracılığıyla bağlanan kullanıcı hesabı sayısına bağlıdır. Belirli fiyatlandırma bilgileri için lütfen fi̇yatlandirma sayfasi Unipile'in web sitesinde. Bu, size hesap sayısına bağlı olarak farklı fiyatlandırma kademeleri hakkında ayrıntılar sağlayacak ve özel entegrasyon ihtiyaçlarınızla ilişkili maliyetleri anlamanıza yardımcı olacaktır.

Unipile geniş kapsamlı dokümantasyon geliştirici kılavuzu, API referansları ve öğreticiler de dahil olmak üzere Gmail API'sinde. Bu kaynaklar, sorun giderme ve API entegrasyonuna yönelik en iyi uygulamalar hakkında tavsiye almak için faydalıdır.