Bu sayfada, Developer Knowledge API için Cloud istemci kitaplıklarını kullanmaya nasıl başlayacağınız gösterilmektedir. İstemci kitaplıkları, ham HTTP istekleri oluşturmak yerine yazmanız gereken kod miktarını azaltan deyimsel türler, yerleşik kimlik doğrulama, otomatik sayfalama ve yeniden deneme işleme sağlar.
Google API'leri için istemci kitaplıkları hakkında daha fazla bilgi edinmek üzere İstemci kitaplıkları açıklaması başlıklı makaleyi inceleyin.
İstemci kitaplığını yükleme
Resmi Developer Knowledge API istemci kitaplığını yüklemek için programlama dilinizi seçin:
Go
Modülü Go projenize ekleyin:
go get cloud.google.com/go/developerknowledge/apiv1
Daha fazla bilgi için Go geliştirme ortamı ayarlama başlıklı makaleyi inceleyin.
Java
Maven kullanıyorsanız pom.xml dosyanıza aşağıdaki bağımlılığı ekleyin:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-developer-knowledge</artifactId>
<version>0.6.0</version>
</dependency>
Gradle kullanıyorsanız build.gradle dosyanıza aşağıdaki bağımlılığı ekleyin:
implementation 'com.google.cloud:google-cloud-developer-knowledge:0.6.0'
Daha fazla bilgi için Java geliştirme ortamı ayarlama başlıklı makaleyi inceleyin.
Node.js ve TypeScript
Paketi npm kullanarak yükleyin:
npm install @google/developer-knowledge
Daha fazla bilgi için Node.js geliştirme ortamı oluşturma başlıklı makaleyi inceleyin.
PHP
Paketi Composer kullanarak yükleyin:
composer require google/developer-knowledge
Daha fazla bilgi için Google Cloud'da PHP'yi kullanma başlıklı makaleyi inceleyin.
Python
Paketi pip kullanarak yükleyin:
pip install --upgrade google-developer-knowledge
Daha fazla bilgi için Python geliştirme ortamı oluşturma başlıklı makaleyi inceleyin.
Ruby
Gem'i yükleyin:
gem install google-developers-developer_knowledge
Daha fazla bilgi için Ruby geliştirme ortamı oluşturma başlıklı makaleyi inceleyin.
Kimlik doğrulamayı ayarlama
API isteklerinde bulunmadan önce Google Cloud projenizde Developer Knowledge API'yi etkinleştirdiğinizden emin olun.
İstemci kitaplıkları, Developer Knowledge API'ye yapılan çağrıların kimliğini doğrulamak için Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) destekler. Kitaplıklar, tanımlanmış bir dizi konumda kimlik bilgileri arar ve API'ye yapılan isteklerin kimliğini doğrulamak için bu kimlik bilgilerini kullanır. ADC ile, uygulama kodunuzu değiştirmeniz gerekmeden yerel geliştirme veya üretim gibi çeşitli ortamlarda uygulamanız için kimlik bilgilerini kullanılabilir hale getirebilirsiniz.
Üretim ortamlarında ADC'yi nasıl ayarlayacağınız hizmete ve bağlama bağlıdır:
- Google Cloud ortamları: Uygulamanız Cloud Run, Google Kubernetes Engine, Compute Engine veya Cloud Run işlevlerinde çalışırken ADC, işlem kaynağına eklenen hizmet hesabını otomatik olarak kullanır.
- Harici veya şirket içi ortamlar: Workload Identity Federation'ı kullanın veya
GOOGLE_APPLICATION_CREDENTIALSortam değişkenini bir kimlik bilgisi yapılandırma dosyasının yoluna ayarlayın.
Üretim kimlik bilgisi seçenekleri hakkında daha fazla bilgi edinmek için Uygulama Varsayılan Kimlik Bilgileri'ni ayarlama başlıklı makaleyi inceleyin.
Yerel geliştirme ortamı için Google Hesabınızla ilişkili kimlik bilgilerini kullanarak ADC'yi ayarlayabilirsiniz:
- gcloud CLI'yı yükleyin ve başlatın.
Google Hesabınız için yerel kimlik doğrulama kimlik bilgileri oluşturun:
gcloud auth application-default loginOturum açma ekranı görünür. Oturum açtıktan sonra kimlik bilgileriniz, ADC tarafından kullanılan yerel kimlik bilgisi dosyasında saklanır.
Ek kaynaklar
Her istemci kitaplığı için API referans belgelerine, kod örneklerine, en iyi uygulamalara, sorun izleyicilere ve kaynak kodu depolarına bağlantılar bulmak üzere bir dil sekmesi seçin:
Go
Aşağıdaki listede Go için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
Java
Aşağıdaki listede, Java için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
Node.js ve TypeScript
Aşağıdaki listede, Node.js ve TypeScript için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
PHP
Aşağıdaki listede, PHP için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
Python
Aşağıdaki listede, Python için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
Ruby
Aşağıdaki listede, Ruby için istemci kitaplığıyla ilgili daha fazla kaynağın bağlantıları yer almaktadır:
Sırada ne var?
AnswerQuery,SearchDocumentChunks,GetDocumentveBatchGetDocumentsiçin kod örneklerini görüntülemek ve çalıştırmak üzere istemci kitaplıkları hızlı başlangıç kılavuzunu inceleyin.- Belgeleri arama ve alma bölümünde sorgu filtreleri, sayfalara ayırma ve alan maskeleri hakkında daha fazla bilgi edinin.
- Belgelerden yanıt oluştur ile temellendirilmiş üretimi kullanın.
- Hata işleme, sıklık sınırlama ve kota yönetimi bölümündeki yeniden deneme stratejilerini ve durum kodlarını inceleyin.
- Desteklenen tüm doküman alanlarını görüntülemek için corpus referansına göz atın.