Google Console Yapılandırması

Google Workspace modülünün Google hizmetleriyle iletişim kurabilmesi için bir Google Cloud projesi oluşturmanız, gerekli API'leri etkinleştirmeniz ve OAuth kimlik bilgileri oluşturmanız gerekir. Bu kılavuz sizi her adımda yönlendirir.

Adım 1: Google Cloud Projesi Oluşturma

1. Google API Console adresine gidin.
2. Üst gezinti çubuğunda Proje seç düğmesine tıklayın, ardından Yeni Proje'ye tıklayın.
3. Bir Proje Adı girin (ör. "Concord CRM Entegrasyonu").
4. Oluştur düğmesine tıklayın ve projenin hazırlanmasını bekleyin.
5. Proje açılır menüsünde yeni projenin seçili olduğundan emin olun.

bilgi

Yeniden kullanmak istediğiniz mevcut bir Google Cloud projeniz varsa, yeni bir tane oluşturmak yerine proje listesinden onu seçin.

Adım 2: Gerekli API'leri Etkinleştirme

Projeniz seçiliyken, aşağıdaki API'lerin her birini etkinleştirin:

1. API'ler ve Hizmetler → Kitaplık bölümüne gidin.
2. Her API'yi ayrı ayrı arayın ve etkinleştirin:
   • Google Drive API
   • Google Docs API
   • Google Sheets API
   • Google Slides API

Her API için:

1. Arama sonuçlarında API adına tıklayın.
2. Etkinleştir düğmesine tıklayın.
3. Bir sonrakine geçmeden önce onayı bekleyin.

uyarı

Modülün doğru çalışması için dört API'nin tamamı etkinleştirilmelidir. Herhangi bir API eksikse, ilgili Google hizmetine CRM'den erişilemez.

Adım 3: OAuth Onay Ekranını Yapılandırma

1. API'ler ve Hizmetler → OAuth onay ekranı bölümüne gidin.
2. Kullanıcı Türünü seçin:
   • Harici -- Çoğu kurulum için önerilir. Herhangi bir Google hesabının yetkilendirme yapmasına olanak tanır.
   • Dahili -- Yalnızca Google Workspace (ücretli) hesapları için kullanılabilir. Erişimi organizasyonunuzdaki kullanıcılarla sınırlar.
3. Oluştur düğmesine tıklayın.
4. Gerekli alanları doldurun:
   • Uygulama Adı -- Kullanıcıların yetkilendirme sırasında göreceği ad (ör. "Concord CRM").
   • Kullanıcı Destek E-postası -- Destek e-posta adresiniz.
   • Geliştirici İletişim Bilgileri -- E-posta adresiniz.
5. Kapsamlar ve Test Kullanıcıları adımlarından Kaydet ve Devam Et düğmesine tıklayarak geçin (temel kurulum için değişiklik gerekmez).
6. Özet sekmesinden Kontrol Paneline Dön düğmesine tıklayın.

Yayınlama Durumu

Durum	HTTPS Gerekli	Notlar
Test	Hayır	100 test kullanıcısıyla sınırlı; ek bir onay uyarısı gösterir
Üretim	Evet	Tüm kullanıcılar için kullanılabilir; siteniz HTTPS kullanmalıdır

ipucu

İlk kurulum ve test için uygulamayı Test modunda tutun. Her şeyin çalıştığını doğruladıktan sonra, sorunsuz bir yetkilendirme deneyimi için Üretim moduna geçin.

Adım 4: OAuth Kimlik Bilgileri Oluşturma

1. API'ler ve Hizmetler → Kimlik Bilgileri bölümüne gidin.
2. Kimlik Bilgileri Oluştur → OAuth istemci kimliği seçeneğine tıklayın.
3. Uygulama türü olarak Web uygulaması'nı seçin.
4. Kimlik bilgisi için bir Ad girin (ör. "Concord CRM OAuth").
5. Yetkili yönlendirme URI'leri altına şunu ekleyin:

https://yourdomain.com/google-workspace/callback

yourdomain.com kısmını Concord CRM'nizin kurulu olduğu gerçek alan adıyla değiştirin.

6. Oluştur düğmesine tıklayın.
7. Bir iletişim kutusu Client ID ve Client Secret bilgilerinizi gösterecektir. Her iki değeri de kopyalayın.

uyarı

Yönlendirme URI'si, protokol (HTTPS) ve yol dahil olmak üzere Concord CRM kurulum URL'nizle tam olarak eşleşmelidir. Yanlış bir yönlendirme URI'si yetkilendirmenin başarısız olmasına neden olur.

Adım 5: Concord CRM'e Bağlanma

1. Concord CRM'nize yönetici olarak giriş yapın.
2. Google Workspace modül ayarlarına gidin.
3. Önceki adımdaki Client ID ve Client Secret bilgilerini yapıştırın.
4. Kaydet ve Yetkilendir düğmesine tıklayın.
5. Bir Google onay ekranı görünecektir. Google hesabınızı seçin ve istenen izinleri verin.
6. Concord CRM'e geri yönlendirileceksiniz. Bağlantı durumu artık Yetkilendirildi olarak görünmelidir.

bilgi

Google Cloud uygulamanız Test modundaysa, yetkilendirme sırasında ek bir uyarı ekranı göreceksiniz. Devam etmek için Devam Et düğmesine tıklayın. Bu uyarı Üretim modunda görünmez.

Sorun Giderme

Sorun	Çözüm
"Error 400: redirect_uri_mismatch"	Google Cloud'daki yönlendirme URI'sinin CRM URL'nizle tam eşleştiğini doğrulayın
Yetkilendirme sessizce başarısız oluyor	Google Cloud projesinde dört API'nin tamamının etkinleştirildiğinden emin olun
"Erişim engellendi: Uygulama doğrulanmadı"	Üretim moduna geçin veya hesabınızı test kullanıcısı olarak ekleyin
Bağlantı bir süre sonra kopuyor	Modül ayarlarından yeniden yetkilendirin; token yenileme ayarlarını kontrol edin

Güvenlik Önerileri

• OAuth kimlik bilgilerini yetkili yönlendirme URI'leri kullanarak belirli alan adınızla sınırlayın.
• OAuth token'larını aktarım sırasında korumak için Concord CRM kurulumunuzda HTTPS kullanın.
• Gereksiz izinlerin verilmediğinden emin olmak için Google Cloud Console'da API erişimini düzenli olarak gözden geçirin.
• Kimlik bilgilerinin ele geçirildiğinden şüpheleniyorsanız kimlik bilgilerini yenileyin.

Destek

Google Cloud projenizi yapılandırma konusunda yardıma ihtiyacınız varsa, yardım için Themesic Destek Bilet Alanı'nı ziyaret edin.