效能

Perl 適用的用戶端程式庫可簡化與 Google Ads API 的互動，您只需進行最少的設定。不過，效能高度取決於程式庫的使用和整合方式。

這些最佳做法大多適用於所有語言。本指南將介紹 Perl 專屬的項目。

剖析應用程式

分析應用程式的 CPU 和記憶體用量，找出效能瓶頸。Devel::NYTProf 是一個功能強大的 Perl 原始碼剖析器，值得您深入瞭解。

Perl 版本

建議定期升級至較新的 Perl 版本，因為新版本通常整體效能較佳。如要查看最新 Perl 版本，以及這個頁面中程式庫的最低必要版本，請參閱這裡。

記錄

大量記錄可能會導致執行時間大幅增加，並消耗大量記憶體。建議您將任何正式版程式碼的記錄層級設為 WARN。

如要進一步瞭解摘要和詳細記錄器的設定，請參閱記錄指南。

Search 或 SearchStream 方法

Google Ads API 提供兩種主要方法來擷取物件：Search (使用分頁) 和 SearchStream (使用串流)。SearchStream 方法的效能優於 Search 方法，但在某些情況下，Search 方法可能較為合適。

如要進一步瞭解這兩種方法，請參閱這篇文章。

HTTP 逾時

Perl 用戶端程式庫提供介面，可在用戶端層級設定 HTTP 超時：

my $api_client = Google::Ads::GoogleAds::GoogleAdsClient->new({
  # Set HTTP timeout to 5 minutes.
  http_timeout   => 300
});

預設值是根據 Constants.pm 中的 DEFAULT_HTTP_TIMEOUT 設定而定。如果需要強制縮短 API 呼叫時間上限，請設定較低的值。

您可以將逾時時間設為 2 小時以上，但對於執行時間極長的要求，API 仍可能逾時並傳回 DEADLINE_EXCEEDED 錯誤。如果遇到這類錯誤，請將要求分割成多個區塊，並平行執行這些區塊；這樣可避免長時間執行的要求失敗，且只能從頭再次觸發要求才能復原的情況。