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

Google Cloud Search API'yi doğrudan veya bir SDK üzerinden kullanmadan önce API'ye erişimi yapılandırmanız gerekir. Bu belgede, Cloud Search API REST API 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şturun. Bu proje, Google Cloud hizmetlerini kullanmanın, API'leri yönetmenin ve izinleri ayarlamanın temelini oluşturur.

  1. Google Cloud Console'u açın.
  2. "Google Cloud Console"un sağındaki proje açılır listesini tıklayın ve YENİ PROJE'yi seçin.
  3. Proje Adı alanına bir ad girin.
  4. (İsteğe bağlı) Proje kimliğini değiştirmek için Düzenle'yi tıklayın. Bu kimliği oluşturduktan sonra değiştiremezsiniz.
  5. Konum seçmek için GÖZ AT'ı, ardından Seç'i tıklayın.
  6. Oluştur'u tıklayın. Proje genellikle birkaç dakika içinde hazır olur.

Daha fazla bilgi için Proje Oluşturma ve Yönetme başlıklı makaleyi inceleyin.

2. API'yi etkinleştirme

Cloud Search API'yi etkinleştirin ve kimlik bilgilerini almak için bir hizmet hesabı oluşturun.

  1. Google Cloud Console başlığındaki açılır menüden yeni projenizi seçin.
  2. API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i tıklayın.
  3. Google Cloud Search API'yi arayıp seçin.
  4. Etkinleştir'i tıklayın.

Daha fazla bilgi için Google Cloud Console'da API'leri yönetme başlıklı makaleyi inceleyin.

3. Hizmet hesabı kimlik bilgileri oluşturma

  1. Google Cloud Console'da, sol gezinme panelinde Kimlik bilgileri'ni tıklayın.
  2. Kimlik bilgisi oluştur açılır menüsünden Hizmet hesabı'nı seçin.
  3. Hizmet hesabı adı alanına bir ad girin.
  4. (İsteğe bağlı) Hizmet hesabı kimliğini düzenleyin.
  5. Oluştur ve devam et'i tıklayın.
  6. "Hizmet hesapları" listesine ulaşmak için Bitti'yi tıklayın.
  7. Yeni hizmet hesabınızın e-postasını tıklayın, ardından Anahtarlar sekmesini seçin.
  8. ANAHTAR EKLE > Yeni anahtar oluştur'u tıklayın.
  9. JSON'u seçip Oluştur'u tıklayın. Özel anahtar bilgisayarınıza indirilir.

Daha fazla bilgi için Hizmet hesapları başlıklı makaleyi inceleyin.

4. Hizmet hesabı e-posta adresini belirleme

  1. Google Cloud Console'da projenizi seçin.
  2. Gezinme menüsü > IAM ve Yönetici > Hizmet Hesapları'nı tıklayın.
  3. Hizmet hesabınızın e-posta adresini not edin. Cloud Search'e veri kaynağı eklemek için bu bilgiye ihtiyacınız vardır.

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

Diğer Cloud Search API'lerini çağırmadan önce Google Cloud Search için üçüncü taraf desteğini başlatın.

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

  1. Cloud Search platformu projenizde web uygulaması kimlik bilgileri oluşturun. Kimlik bilgisi oluşturma başlıklı makaleyi inceleyin. İstemci kimliği ve istemci gizli anahtarı gerekir.
  2. OAuth 2.0 Playground'u kullanarak erişim jetonu alma:
    1. OAuth 2.0 Yapılandırması'nı (ayarlar simgesi) tıklayın ve Kendi OAuth kimlik bilgilerinizi kullanın'ı işaretleyin.
    2. İstemci kimliğinizi ve istemci sırrınızı girin.
    3. Kapsamlar alanına https://www.googleapis.com/auth/cloud_search.settings girin ve API'leri yetkilendir'i tıklayın.
    4. Jetonlar için yetkilendirme kodu değiş tokuşu yap seçeneğini tıklayın.

  3. [YOUR_ACCESS_TOKEN] kısmını jetonunuzla değiştirerek şu curl komutunu çalıştırın:

    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 bir operation içerir. Başarısız olursa Cloud Search Destek Ekibi ile iletişime geçin.

  4. Başlatma işlemini doğrulamak için operations.get kodunu kullanın:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    done true olduğunda başlatma işlemi tamamlanır.

Sonraki Adımlar

  1. Cloud Search'ü Microsoft® SharePoint® gibi Google dışı bir depoyla kullanmak için veri kaynağı oluşturmanız gerekir. Aramaya veri kaynağı ekleme başlıklı makaleyi inceleyin.
  2. Veri kaynağınızı ayarladıktan sonra, Cloud Search'ün verilerinizi nasıl temsil edeceğini belirlemek için bir şema oluşturup kaydedin. Cloud Search'ün verileri nasıl temsil etmesi gerektiğini belirleyin.