Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ไลบรารีของไคลเอ็นต์ Perl

ไลบรารีของไคลเอ็นต์ Perl โฮสต์อยู่ใน GitHub และแพ็กเกจพร้อมใช้งานใน CPAN

ไลบรารีรองรับ Perl เวอร์ชัน 5.28.1 ขึ้นไป

โปรโตคอล REST API

เอนทิตีคลาส เช่น บริการ ทรัพยากร enum และข้อผิดพลาด ในไลบรารีของไคลเอ็นต์ Perl สร้างขึ้นโดยการแยกวิเคราะห์คำจำกัดความของบัฟเฟอร์โปรโตคอล ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดรูปแบบข้อมูลที่มีโครงสร้างเป็นอนุกรมได้ในเอกสารประกอบเกี่ยวกับบัฟเฟอร์โปรโตคอล

ในการเชื่อมต่อกับ Google Ads API ไลบรารีของไคลเอ็นต์จะสร้างคำขอ HTTP ใน JSON, ส่งไปยังปลายทาง REST ผ่าน HTTP 1.1, ดีซีเรียลไลซ์การตอบกลับเป็นออบเจ็กต์ JSON และตีความผลลัพธ์

ติดตั้งไลบรารี

ไลบรารีของไคลเอ็นต์ Perl โฮสต์อยู่ใน GitHub และเผยแพร่โดยใช้ CPAN

ติดตั้งจาก CPAN

ติดตั้งการกระจาย Google::Ads::GoogleAds::Client โดยตรงจาก CPAN โดยใช้ cpanm (หรือ cpan) ดังนี้

cpanm Google::Ads::GoogleAds::Client

สร้างจากแหล่งที่มาและเรียกใช้ตัวอย่าง

หากต้องการเรียกใช้ตัวอย่างโค้ดที่รวมมาหรือสร้างไลบรารีจากแหล่งที่มา ให้ทำดังนี้

โคลนไลบรารีจาก GitHub โดยทำดังนี้
```
git clone https://github.com/googleads/google-ads-perl.git
```
เปลี่ยนเป็นไดเรกทอรี google-ads-perl โดยทำดังนี้
```
cd google-ads-perl
```
คุณจะเห็นไฟล์และไดเรกทอรีย่อยบางรายการดังนี้
- Build.PL: ไฟล์บิลด์ Perl ซึ่งเก็บทรัพยากร Dependency และประเภทการทดสอบของโปรเจ็กต์นี้
- lib: ซอร์สโค้ดของไลบรารี
- t: กรอบการทดสอบของโค้ดไลบรารี
- examples: ตัวอย่างมากมายที่แสดงวิธีใช้ไลบรารีเพื่อดำเนินการกรณีการใช้งานทั่วไปโดยใช้ Google Ads API
- googleads.properties: ไฟล์การกำหนดค่าตัวอย่างสำหรับไลบรารี
- log4perl.conf: ไฟล์การกำหนดค่าการบันทึกตัวอย่าง
ติดตั้งทรัพยากร Dependency ที่จำเป็นและสร้างไลบรารี ไฟล์ Build.PL จะแสดงรายการทรัพยากร Dependency ทั้งหมดที่จำเป็นสำหรับไลบรารี คุณติดตั้งได้โดยเรียกใช้คำสั่งต่อไปนี้
```
cpan install Module::Build
perl Build.PL
./Build installdeps
./Build
./Build install
```

ทำการเรียก API ครั้งแรก

หากต้องการใช้ Google Ads API คุณต้องทำตามขั้นตอนหลายขั้นตอนเพื่อรับสิทธิ์เข้าถึง API และกำหนดค่าบัญชี Google Ads ทำตามคู่มือเริ่มใช้งานฉบับย่อ ซึ่งจะแนะนำขั้นตอนสำคัญทั้งหมด รวมถึงการตั้งค่าบัญชี Google Ads

การใช้งานพื้นฐาน

เริ่มต้น Google::Ads::GoogleAds::Client (ซึ่งจะโหลดข้อมูลเข้าสู่ระบบจาก ~/googleads.properties หรือ GOOGLE_ADS_CONFIGURATION_FILE_PATH โดยค่าเริ่มต้น) และสตรีมแถวแคมเปญโดยใช้ SearchStreamHandler:

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 ได้ที่คู่มือการใช้งานเบื้องต้น

การตรวจสอบสิทธิ์และการให้สิทธิ์

ไลบรารีของไคลเอ็นต์ Perl รองรับการตรวจสอบสิทธิ์และการให้สิทธิ์หลายวิธี ดูข้อมูลเพิ่มเติมได้ที่คู่มือการตรวจสอบสิทธิ์และการให้สิทธิ์

การกำหนดค่าและการบันทึก

ไลบรารีของไคลเอ็นต์ Perl ใช้ googleads.properties สำหรับการกำหนดค่าและ log4perl.conf สำหรับการบันทึก คุณสามารถแก้ไขไฟล์เหล่านี้เพื่อปรับแต่งลักษณะการทำงานของไลบรารีได้ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการกำหนดค่าและการบันทึก

ยูทิลิตี

ไลบรารีของไคลเอ็นต์ Perl มีคลาสยูทิลิตีเพื่อปรับปรุงความสามารถในการใช้งาน API ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำต่อไปนี้

ปรับแต่งประสิทธิภาพของแอปพลิเคชัน

ดูคู่มือประสิทธิภาพเพื่อดูคำแนะนำเกี่ยวกับวิธีปรับแต่งประสิทธิภาพของแอปพลิเคชัน