Workcube - Google Entegrasyonu Nasıl Kullanılır?

Google API Oluşturma

Süper Admin kullanıcısı olarak https://console.developers.google.com/ web adresine girin. Workcube ile entegre olan Google uygulamalarını kullanmak için yapılması gerekenler nelerdir? Hangi adımlar izlenmeli?

• Görseldeki numaralandırılmış adımları izleyerek yeni bir proje oluşturma sayfasına geçin.
  • Proje seçimi
  • Organizasyon seçimi
  • Yeni proje
    

• Üstteki görselde yer alan bölümleri doldurun. Organization bölümünü seçtiğinizde, Location bölümü otomatik doldurulacak. Create butonuna basın.
• Proje oluşturulduktan sonra, ilk görseldeki Select Project kısmından projenizi seçin.

• Görseldeki adımları izleyerek API ekranına girin.
  

• Create Credentials menüsünden API key seçin.

• API key oluşturulduktan sonra, key bilgisi bulunan bir pencere açılacak. Buradan Restrict Key seçerek Key’i sınırlandırmanız gerekiyor.

• Bu sizi, API ayarları sayfasına yönlendirecek. Buradan, aşağıdaki görseldeki seçeneklere ulaşabilirsiniz. Ayarları görseldeki gibi yapın.

• Öncelikle web sites seçmeniz gerekiyor. Sonrasında alttaki alan açılacak. ADD ITEM bağlantısına tıkladığınızda, görselde okla işaretlenmiş olan domain alanı açılacak. Bu kısımla ilgili ayrıntıları sağdaki açıklama alanında bulabilirsiniz.
• Ardından DONE butonuna basarak domaini ekleyin.
• Aynı sayfanın aşağısında API kısıtlamaları var. Buradaki ayarları da alttaki görseldeki gibi yapın.

• Restrict Key seçeneğini işaretleyin. Ardından Select APIs kısmına basın ve oluşturduğunuz API key ile kullanmak istediğiniz API’ları seçin.
• Ardından Save butonuna basarak işlemleri kaydedin.
• Bu alanda kullanmak istediğiniz API’lar yoksa, sol menüden Library bağlantısına tıklayarak, kullanmak istediğiniz API’ları etkinleştirebilirsiniz.

• Arama alanına kullanmak istediğiniz API adını yazarak istediğiniz bir API’ı etkinleştirebilirsiniz.
• Ardından yine API key ayar sayfasına giderek bu API için kısıtlamayı düzenleyebilirsiniz. 

Google Client Id ve Client Secret Oluşturmak

Bazı API’ları kullanabilmek için Client ID ve Client Secret gerekiyor. Bunu etkinleştirmek için aşağıdaki yönergeleri takip edin.

• Öncelikle projenizin kimler için olduğunu seçmeniz gerekiyor.

             Internal: Yalnızca Workspace alanınızda bulunan kullanıcılar kullanabilir.

             External: Workspace alanınızda olmayan kullanıcılar da kullanabilir. Ancak bunun için Google’a bu uygulamayı onaylatmanız gerekiyor.

• Create butonuna bastıktan sonra, ayarlar sayfasına yönlendirileceksiniz.
• Üç aşamalı bir işlem yapmanız gerekiyor.
• OAuth consent screen, Scopes, Summary...
• OAuth Consent Screen Sayfasındaki İşlemler: 

                   App Information: Uygulama adı, destek maili ve uygulama logosu. Bunlar, mail adreslerini kullanarak Google servisini kullanacak kişilere de                                   gösterilecek. Zorunludur.

                  App Domain: Kullanıcının, google hesabıyla giriş yapacağı ekranda, kullanıcıya gösterilecek bilgiler içerir. Site ana sayfa, privacy policy vb. Linkler                        girebilirsiniz. Zorunlu değil.

                  Authorized Domains: Bu kısıma da, Google API kullanılacak web sayfalarını yazmalısınız. 

                  Developer Contact Information: Geliştirici mail adresi yazılmalı. İşlem yapan kişinin mail adresi yazılabilir.

• Save And Continue butonuna basarak devam edin.
• Scopes sayfasındaki işlemler:
  • Add or Remove Scopes butonuna basın ve kullanılacak API’ları listeden aratın ve yanlarındaki checkbox’ı kullanarak seçin. (Seçebilmek için API etkinleştirilmiş olmalı.) Sonra, alttaki UPDATE butonuna basın.

• Save and Continue diyerek devam edin.
• Summary kısmına geçeceksiniz. Burası yaptığınız işlemlerin özet kısmı. Buradan yaptığınız ayarları kontrol edip isterseniz düzenleyebilirsiniz. Sorun yoksa burada da Back to Dashboard diyerek işlemi bitirebilirsiniz.
• Client ID ve Client Secret oluşturmak için:
• Görselde işaretli alanları, numara sıralarıyla açın.

• Bu işlem sonrası Client için Ayarlar sayfasına yönlendirileceksiniz.
  
• Application Type: Web Application
• Name: İstediğiniz bir isim verebilirsiniz. Oluşturduğunuz Client için isim belirliyorsunuz.
• Authorized JavaScript Origins: Bu Client ile iletişime geçecek JavaScript kodlarının hangi sitede çalışacağını seçiyorsunuz. Add URL diyerek kendi site adresinizi yazın.
• Authorized Redirect URLs: Kullanıcı bu API ve Client ID’yi kullanarak giriş yaptığında, yönlendirilmesine izin verdiğiniz site adreslerini yazıyorsunuz. Yine Add URL diyerek kendi site adresinizi yazın.
• Create butonuna basarak onaylayın.

• Açılan pencerede Client ID ve Client Secret bilgilerinizi bulabilirsiniz. Bu pencereyi kapattıktan sonra bu bilgilere, Credentials sayfasında, liste olarak ulaşabilirsiniz. Key ve Client ID kolonlarında kopyalama simgesini kullanarak kopyalama yapabilirsiniz. Client Secret’a ulaşmak için, Actions kolonunda bulunan kalem simgesine basarak ayrıntılara ulaşabilirsiniz.

Workcube'de Kullanılan API'lar:

Workcube ile entegre olan Google Hizmetleri için etkinleştirmeniz gereken API listesi aşağıdaki gibidir:

• Cloud Speech-to-Text API (Ücretli)
• Cloud Text-to-Speech API (Ücretli)
• Geocoding API (Ücretli)
• Google Calendar API (Ücretsiz)
• Google Docs API (Ücretsiz)
• Google Drive API (Ücretsiz)
• Google Sheets API (Ücretsiz)
• Maps JavaScript API (Ücretsiz)
• Places API (Ücretli)

Bu API’lardan ücretli olanları kullanmak için, Google Console üzerinden ödeme bilgilerini girmeniz zorunludur.

• https://console.developers.google.com/billing adresinden Create Account diyerek gerekli bilgileri girip, yeni bir ödeme yöntemi girebilirsiniz.