Google Cloud Search API'ye erişimi yapılandırma

Bu API'yi doğrudan veya bir SDK aracılığıyla kullanmadan önce Google Cloud Search API'ye erişimi yapılandırmanız gerekir. Bu belgede, Google Cloud Search API REST API'yi kullanmak için gereken adımlar açıklanmaktadır.

1. API projesi oluşturma

API'yi etkinleştirmek için önce bir Google Cloud projesi oluşturmanız gerekir. Bu proje; API'leri yönetme, faturalandırmayı etkinleştirme, ortak çalışan ekleyip kaldırma ve izinleri yönetme de dahil olmak üzere tüm Google Cloud hizmetlerinin oluşturulması, etkinleştirilmesi ve kullanılması için temel oluşturur.

1. Google Cloud Console'u açın.

2. Sayfanın üst kısmında, "Google Cloud Console"un sağındaki simgesini tıklayın. Mevcut projeleri listeleyen bir iletişim kutusu görünür.

3. YENİ PROJE'yi tıklayın. "Yeni Proje" ekranı görünür.

4. Proje Adı alanına bir proje adı girin.

5. (isteğe bağlı) Proje kimliğini düzenlemek için Düzenle'yi tıklayın. Proje kimliği, proje oluşturulduktan sonra değiştirilemez. Bu nedenle, proje süresince ihtiyaçlarınıza uygun bir kimlik seçin.

6. Projenin konumlarına göz atmak için GÖZ AT'ı tıklayın.

7. Projenizin konumunu tıklayın ve Seç'i tıklayın.

8. Oluştur'u tıklayın. Konsol, Kontrol Paneli sayfasına gider. Proje birkaç dakika içinde oluşturulur.

Proje oluşturma ve yönetme hakkında daha fazla bilgi için Proje Oluşturma ve Yönetme bölümüne bakın.

2. API'yi etkinleştirme

Kimlik bilgilerini almak için Google Cloud Search API'yi etkinleştirmeniz ve bir hizmet hesabı oluşturmanız gerekir.

1. Yeni oluşturulan projede olduğunuzdan emin olmak için Google Cloud Console banner'ının sağındaki simgesini tıklayın ve yeni oluşturduğunuz projeyi seçin.
2. API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i tıklayın. "API Kitaplığı'na Hoş Geldiniz" sayfası görünür.
3. Google Cloud Search API'ye gidin.
4. Etkinleştir'i tıklayın. "Genel Bakış" sayfası görünür.

API'leri etkinleştirme ve devre dışı bırakma hakkında daha fazla bilgi için Google Cloud Console'da API'leri yönetme bölümüne bakın.

Not: Farklı Cloud Search API'lerinin yürütülmesi için farklı hesaplar (yönetici, hizmet ve kullanıcı) gerekir. Daha fazla bilgi için çağırmak istediğiniz yöntemle ilgili referans belgelerini inceleyin.

3. Hizmet hesabı kimlik bilgileri oluşturma

1. Google Cloud Console'da, soldaki gezinme bölümünden Kimlik bilgileri'ni tıklayın. Kimlik bilgisi sayfası görüntülenir.
2. Kimlik bilgileri oluştur açılır listesinden Hizmet hesabı'nı seçin. "Hizmet hesabı oluştur" sayfası görünür.
3. Hizmet hesabı adı alanına bir ad girin.
4. (isteğe bağlı) Hizmet hesabı kimliğini düzenleyin.
5. Oluştur'u tıklayın. "Hizmet hesabı izinleri" ekranı görüntülenir.
6. Devam'ı tıklayın. "Kullanıcıların bu hizmet hesabına erişmesine izin ver" ekranı görünür.
7. ANAHTAR OLUŞTUR'u ve Bitti'yi tıklayın. "Özel anahtar bilgisayarınıza kaydedildi" iletişim kutusu açılır ve özel anahtarın bir kopyası bilgisayarınıza indirilir.
8. Close'u (Kapat) tıklayın.

Hizmet hesapları hakkında daha fazla bilgi için Hizmet hesapları, web uygulamaları ve yüklü uygulamalar bölümüne bakın.

4. E-posta adresini tanımlayın

1. Google Cloud Console'dan, sayfanın üst kısmında oluşturduğunuz projeyi seçin.
2. Google Cloud Console banner'ının solundaki gezinme menüsünü tıklayın.
3. IAM ve Yönetici > Hizmet hesapları'nı tıklayın.
4. Listede, "Hizmet hesabı kimliği"nin altında, yapılandırdığınız hizmet hesabını tanımlayan, oluşturulmuş e-posta adresini not edin. Cloud Search'e veri kaynağı eklerken bu e-posta adresi kullanılır.

5. Üçüncü taraf desteğini başlatma

Başka bir Cloud Search API'sini çağırabilmek için öncelikle Google Cloud Search için üçüncü taraf desteğini başlatmanız gerekir.

Not: Cloud Search eğiticisini başarıyla yürüttüyseniz Cloud Search için üçüncü taraf desteğini zaten başlatmışsınız demektir ve bu adımı atlayabilirsiniz.

Cloud Search için üçüncü taraf desteğini başlatmak için:

1. Cloud Search platform projenizde hizmet hesabı kimlik bilgileri bulunuyor. Ancak üçüncü taraf desteğini başlatmak için web uygulaması kimlik bilgileri oluşturmanız gerekir. Web uygulaması kimlik bilgilerinin nasıl oluşturulacağına ilişkin talimatlar için Kimlik bilgileri oluşturma bölümüne bakın. Bu adımı tamamladıktan sonra, bir istemci kimliği ve istemci gizli anahtarı dosyanız olmalıdır.

2. Erişim jetonu almak için Google'ın OAuth 2 oyun alanını kullanın:

   1. Ayarlar'ı tıklayın ve Kendi kimlik doğrulama bilgilerinizi kullanın seçeneğini işaretleyin.
   2. 1. adımdaki istemci kimliğini ve istemci gizli anahtarını girin.
   3. Close'u (Kapat) tıklayın.
   4. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings yazıp Yetkilendir'i tıklayın. OAuth 2 oyun alanı bir yetkilendirme kodu döndürür.
   5. Jetonlar için yetkilendirme kodu değiş tokuşu yap seçeneğini tıklayın Bir jeton döndürülür.

3. Cloud Search için üçüncü taraf desteğini başlatmak istiyorsanız aşağıdaki curl komutunu kullanın. [YOUR_ACCESS_TOKEN] yerine 2. adımda elde ettiğiniz jetonla değiştirin.

   curl --request POST \
   'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
     --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '{}' \
     --compressed
   

   Başarılı olursa yanıt gövdesi, operation öğesinin bir örneğini içerir. Örneğin:

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   }
   

   Başarısız olursa Cloud Search destek ekibiyle iletişime geçin.

4. Üçüncü taraf desteğin başlatıldığını doğrulamak için operations.get dosyasını kullanın:

   curl \
   'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
   [YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   Üçüncü taraf başlatma işlemi tamamlandığında true olarak ayarlanmış done alanını içerir. Örneğin:

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   done: true
   }
   

Sonraki adımlar

Atabileceğiniz sonraki adımlardan bazıları şunlardır:

1. Google Cloud Search'ü Microsoft® SharePoint® gibi Google'a ait olmayan bir veri deposuyla kullanmayı planlıyorsanız bir veri kaynağı oluşturmanız gerekir. Veri kaynağı eklemeyle ilgili talimatlar için Arama yapmak için veri kaynağı ekleme başlıklı makaleyi inceleyin.

2. Veri kaynağınızı ayarladıktan sonra, Google Cloud Search'ün depodaki verileri nasıl temsil etmesi gerektiğini tanımlamak için şema oluşturup kaydedebilirsiniz.