Perl İstemci Kitaplığı

Perl istemci kitaplığı GitHub'da barındırılır ve paket CPAN'da kullanılabilir.

Kitaplık, Perl 5.28.1 veya sonraki sürümlerini destekler.

REST API protokolü

Not: Google Ads API hem standart JSON REST uç noktalarını hem de yüksek performanslı bir gRPC arayüzünü kullanıma sunar. Perl, gRPC yığınında desteklenen bir dil olmadığından bu istemci kitaplığı, HTTP 1.1 üzerinden JSON REST protokolünde uygulanır.

Perl istemci kitaplığındaki hizmet, kaynak, enum ve hata gibi sınıf öğeleri, protokol arabelleği tanımları ayrıştırılarak oluşturulur. Yapılandırılmış verilerin nasıl serileştirildiği hakkında daha fazla bilgi edinmek için protocol buffer dokümanlarına bakın.

İstemci kitaplığı, Google Ads API'ye bağlanmak için JSON biçiminde bir HTTP isteği oluşturur, bunu HTTP 1.1 üzerinden REST uç noktasına gönderir, yanıtı JSON nesnesi olarak seri durumdan çıkarır ve sonuçları yorumlar.

Kitaplığı yükleme

Perl istemci kitaplığı GitHub'da barındırılır ve CPAN kullanılarak dağıtılır.

1. Kitaplığı GitHub'dan kopyalayın:

   git clone https://github.com/googleads/google-ads-perl.git
   

2. google-ads-perl dizinine geçin:

   cd google-ads-perl
   

   Bazı dosyalar ve alt dizinler görürsünüz:

   • Build.PL: Bu projenin bağımlılıklarını ve test türlerini içeren Perl derleme dosyası.
   • lib: Kitaplığın kaynak kodu.
   • t: Kitaplık kodunun test senaryoları.
   • examples: Kitaplığın Google Ads API ile yaygın kullanım alanlarında nasıl kullanılacağını gösteren birçok örnek.
   • googleads.properties: Kitaplığın örnek yapılandırma dosyası.
   • log4perl.conf: örnek günlük kaydı yapılandırma dosyası.

3. Gerekli bağımlılıkları yükleyin. Build.PL dosyasında, kitaplık için gereken tüm bağımlılıklar listelenir. Aşağıdaki komutları çalıştırarak bunları yükleyebilirsiniz:

   cpan install Module::Build
   perl Build.PL
   perl Build installdeps
   

İlk API çağrınızı yapma

Google Ads API'yi kullanmak için API'ye erişmek ve Google Ads hesaplarınızı yapılandırmak üzere çeşitli adımlar uygulamanız gerekir. Google Ads hesaplarınızı ayarlama da dahil olmak üzere tüm önemli adımlarda size yol gösterecek hızlı başlangıç kılavuzunu incelemenizi öneririz.

Temel kullanım

Perl istemci kitaplığını kullanma hakkında daha fazla bilgi edinmek için temel kullanım kılavuzuna bakın.

Kimlik doğrulama ve yetkilendirme

Perl istemci kitaplığı, kimlik doğrulama ve yetkilendirme için birden fazla yaklaşımı destekler. Daha fazla bilgi için Kimlik Doğrulama ve Yetkilendirme kılavuzuna bakın.

Yapılandırma ve günlük kaydı

Perl istemci kitaplığı, yapılandırma için googleads.properties, günlük kaydı için ise log4perl.conf kullanır. Kitaplığın davranışını özelleştirmek için bu dosyaları değiştirebilirsiniz. Daha fazla bilgi için Günlüğe kaydetme kılavuzuna bakın.

Yardımcı Programlar

Perl istemci kitaplığı, API'nin kullanılabilirliğini artırmak için birkaç yardımcı sınıf içerir. Daha fazla bilgi edinmek için aşağıdaki rehberleri inceleyin:

• Alan maskeleri
• Kaynak adları

Uygulama performansınızı iyileştirme

Uygulamanızın performansını iyileştirmeyle ilgili öneriler için Performans rehberine bakın.