Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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

Google Cloud Console'u açın.
Sayfanın üst kısmında, "Google Cloud Console"un sağındaki simgesini tıklayın. Mevcut projelerin listelendiği bir iletişim kutusu açılır.
YENİ PROJE'yi tıklayın. "Yeni Proje" ekranı görünür.
Proje adı alanına bir proje adı girin.
(İsteğ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, proje süresince ihtiyaçlarınızı karşılayacak bir kimlik seçin.
Projenin konumlarına göz atmak için GÖZ AT'ı tıklayın.
Projeniz için bir konumu ve Seç'i tıklayın.
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 bilgilerini almak için Google Cloud Search API'yi etkinleştirmeniz ve bir hizmet hesabı oluşturmanız gerekir.

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.
API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i tıklayın. "API Kitaplığına hoş geldiniz" sayfası görünür.
Google Cloud Search API'ye gidin.
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.

3. Hizmet hesabı kimlik bilgileri oluşturma

Google Cloud Console'da, sol gezinme panelinde Kimlik bilgileri'ni tıklayın. Kimlik bilgisi sayfası görüntülenir.
Kimlik bilgisi oluştur açılır listesinden Hizmet hesabı'nı seçin. "Hizmet hesabı oluştur" sayfası görünür.
Hizmet hesabı adı alanına bir ad girin.
(isteğe bağlı) Hizmet hesabı kimliğini düzenleyin.
Oluştur'u tıklayın. "Hizmet hesabı izinleri" ekranı görünür.
Devam'ı tıklayın. "Kullanıcıların bu hizmet hesabına erişmelerine izin ver" ekranı görünür.
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.
Kapat'ı tıklayın.

Hizmet hesapları hakkında daha fazla bilgi için Hizmet hesapları, web uygulamaları ve yüklü uygulamalar başlıklı makaleyi inceleyin.

4. E-posta adresini belirleme

Google Cloud Console'da sayfanın üst kısmından oluşturduğunuz projeyi seçin.
Google Cloud Console banner'ının solundaki gezinme menüsünü tıklayın.
IAM ve Yönetici > Hizmet hesapları'nı tıklayın.
Listede, "Hizmet hesabı kimliği" bölümünde, 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ğırmadan önce Google Cloud Search için üçüncü taraf desteğini başlatmanız gerekir.

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

Cloud Search Platform projeniz hizmet hesabı kimlik bilgilerini içeriyor. Ancak üçüncü taraf desteğini başlatmak için web uygulaması kimlik bilgileri oluşturmanız gerekir. Web uygulaması kimlik bilgileri oluşturma talimatları için Kimlik bilgileri oluşturma başlıklı makaleye bakın. Bu adımı tamamladığınızda bir istemci kimliği ve istemci gizli anahtarı dosyanız olmalıdır.
Erişim jetonu almak için Google'ın OAuth 2 Playground'unu kullanın:
1. Ayarları tıklayın ve Kendi kimlik doğrulama kimlik bilgilerinizi kullanın'ı 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 seçeneğini tıklayın. Bir jeton döndürülür.

Cloud Search için üçüncü taraf desteğini başlatmak üzere aşağıdaki curl komutunu kullanın. [YOUR_ACCESS_TOKEN] yerine 2. adımda aldığınız jetonu kullandığınızdan 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 Ekibi ile iletişime geçin.

Üçü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ı true olarak ayarlanır. Örneğin:

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

Sonraki Adımlar

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

Google Cloud Search'ü Microsoft® SharePoint® gibi Google dışı bir veri deposuyla kullanmayı planlıyorsanız veri kaynağı oluşturmanız gerekir. Veri kaynağı ekleme talimatları için Aramaya veri kaynağı ekleme başlıklı makaleyi inceleyin.
Veri kaynağınızı ayarladıktan sonra, Google Cloud Search'ün depodaki verileri nasıl temsil etmesi gerektiğini belirlemek için şema oluşturup kaydedebilirsiniz.