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 dokümanda, Google Cloud Search API REST API'yi kullanmak için gereken adımlar ele alınmaktadı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 ekleme ve kaldırma ve izinleri yönetme dahil olmak üzere tüm Google Cloud hizmetlerini oluşturma, etkinleştirme ve kullanmanın temelini 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 projelerin listelendiği bir iletişim kutusu görüntülenir.

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 oluşturulduktan sonra proje kimliği değiştirilemez. Bu nedenle, projenin kullanım süresi boyunca ihtiyaçlarınızı karşılayacak bir kimlik seçin.

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

7. Projeniz için bir konumu ve ardından 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 başlıklı makaleyi inceleyin.

2. API'yi etkinleştirme

Kimlik bilgileri edinmek 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 başlıklı makaleyi inceleyin.

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öntemin referans dokümanlarına bakın.

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 bilgileri 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österilir.
6. Devam'ı tıklayın. "Kullanıcıların bu hizmet hesabına erişmelerine 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 görünür ve özel anahtarın bir kopyası bilgisayarınıza indirilir.
8. 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ımlama

1. Google Cloud Console'da, sayfanın üst kısmından 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. Bu e-posta adresi, Cloud Search'e veri kaynağı eklenirken kullanılır.

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

Diğer Cloud Search API'lerini çağırabilmek için 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 üzere:

1. Cloud Search Platform projeniz hizmet hesabı kimlik bilgileri içeriyor. Ancak üçüncü taraf desteğini başlatmak için web uygulaması kimlik bilgileri oluşturmanız gerekir. Web uygulaması kimlik bilgilerini oluşturma talimatları için Kimlik bilgileri oluşturma başlıklı makaleyi inceleyin. Bu adımı tamamladıktan sonra bir istemci kimliğiniz ve istemci gizli anahtar dosyanız olmalıdır.

2. Erişim jetonu almak için Google'ın OAuth 2 Playground'unu 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. Kapat'ı tıklayın.
   4. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings yazın ve Yetkilendir'i tıklayın. OAuth 2 Playground, bir yetkilendirme kodu döndürür.
   5. Jetonlar için yetkilendirme kodu değiş tokuşu yap'ı tıklayın. Bir jeton döndürülür.

3. Cloud Search için üçüncü taraf desteğini başlatmak üzere aşağıdaki curl komutunu kullanın. [YOUR_ACCESS_TOKEN] değerini 2. adımda elde edilen jetonla değiştirdiğinizden emin olun.

   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"
   }
   

   Bu işlem başarısız olursa Cloud Search Destek Ekibi ile iletişime geçin.

4. Üçüncü taraf desteğinin başlatıldığını doğrulamak için operations.get işlevini 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 done alanını true olarak ayarlar. Örneğin:

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

Sonraki Adımlar

Aşağıda, uygulayabileceğiniz birkaç adım verilmiştir:

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ı oluşturduktan sonra, Google Cloud Search'in depodaki verileri nasıl temsil etmesi gerektiğini belirlemek için şema oluşturabilir ve kaydedebilirsiniz.