Perl istemci kitaplığı

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

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

REST API protokolü

Perl istemci kitaplığındaki sınıf varlıkları (ör. hizmet, kaynak, enum ve hata), 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 protokol arabelleği belgelerine 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 durumları.
    • examples: Google Ads API'yi kullanarak yaygın kullanım alanlarını yürütmek için kitaplığın 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 ve kitaplığı oluşturun. Build.PL dosyası, kitaplık için gereken tüm bağımlılıkları listeler. Aşağıdaki komutları çalıştırarak bunları yükleyebilirsiniz:

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

İ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 birkaç adım uygulamanız gerekir. Google Ads hesaplarınızı oluşturma dahil olmak üzere tüm önemli adımlarda size yol gösteren hızlı başlangıç kılavuzunu inceleyin.

Temel kullanım

Perl istemci kitaplığının nasıl kullanılacağı 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 Yapılandırma ve Günlüğe Kaydetme kılavuzlarına bakın.

Yardımcı Programlar

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

Uygulama performansınızda ince ayar yapma

Uygulamanızın performansında ince ayar yapmayla ilgili öneriler için Performans kılavuzuna bakın.