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

Bu API'yi doğrudan veya bir SDK aracılığıyla kullanabilmeniz için ö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 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 ekleyip kaldırma ve izinleri yönetme dahil olmak üzere tüm Google Cloud hizmetlerini oluşturma, etkinleştirme ve kullanma sürecinin temelini oluşturur.

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

  2. Sayfanın üst kısmında, "Google Cloud Console"un sağ tarafındaki simgesini tıklayın. Mevcut projeleri listeleyen bir iletişim kutusu açılı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, projenin ömrü boyunca ihtiyaçlarınızı karşılayan bir kimlik seçin.

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

  7. Projeniz için bir konumu 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ünü inceleyin.

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şturulan projenizi seçin.
  2. API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i tıklayın. "API Kitaplığına Hoş Geldiniz" sayfası görüntülenir.
  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 sayfasına bakın.

3. Hizmet hesabı kimlik bilgileri oluşturma

  1. Google Cloud Console'daki sol gezinme menüsünden Kimlik bilgileri'ni tıklayın. Credential (Kimlik Bilgisi) sayfası görünür.
  2. Kimlik bilgisi oluştur açılır listesinden Hizmet hesabı'nı seçin. "Hizmet hesabı oluştur" sayfası görüntülenir.
  3. Hizmet hesabı adı alanına bir ad girin.
  4. (İsteğe bağlı) Hizmet hesabı kimliğini düzenleyin.
  5. Oluştur'u tıklayın. "Hizmet hesabı izinleri" ekranı görünür.
  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 ardından 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 konusuna bakın.

4. E-posta adresini tanımlama

  1. Google Cloud Console'da, 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. Listedeki "Hizmet hesabı kimliği"nin altında, yapılandırdığınız hizmet hesabını tanımlayan, oluşturulan e-posta adresini not edin. Bu e-posta adresi, Cloud Search'e veri kaynağı eklerken kullanılır.

5. Üçüncü taraf desteğini ilk kullanıma hazırlama

Diğer Cloud Search API'lerini çağırabilmeniz için öncelikle Google Cloud Search'e yönelik üçüncü taraf desteğini başlatmanız gerekir.

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

  1. Cloud Search platformu 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ğine ve istemci gizli anahtarı dosyanıza sahip olmanız gerekir.

  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. 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 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 amacıyla aşağıdaki curl komutunu kullanın. [YOUR_ACCESS_TOKEN] kısmını, 2. adımda aldığınız 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"
}

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

  4. Üçüncü taraf desteğinin 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 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ğı ekleme talimatları için Aramaya veri kaynağı ekleme başlıklı makaleyi inceleyin.

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