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ümleri 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, bu isteği 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.

CPAN'dan yükleme

Google::Ads::GoogleAds::Client dağıtımını cpanm (veya cpan) kullanarak doğrudan CPAN'dan yükleyin:

cpanm Google::Ads::GoogleAds::Client

Kaynaktan derleme ve örnekleri çalıştırma

Paketlenmiş kod örneklerini çalıştırmak veya kitaplığı kaynaktan derlemek için:

  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ığı derleyin. 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

Google::Ads::GoogleAds::Client'ı ilk kullanıma hazırlayın (varsayılan olarak ~/googleads.properties veya GOOGLE_ADS_CONFIGURATION_FILE_PATH'den kimlik bilgilerini yükler) ve SearchStreamHandler kullanarak kampanya satırlarını akış olarak aktarın:

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

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 log4perl.conf kullanır. Kitaplığın davranışını özelleştirmek için bu dosyaları değiştirebilirsiniz. Daha fazla bilgi edinmek 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 iyileştiren 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.