正在擷取物件

GoogleAdsService 是統一物件 Google Ads API 的擷取和報表服務。此服務的方法會具有以下特性：

• 擷取物件的特定屬性。
• 依據日期範圍擷取物件的成效指標。
• 按照物件屬性排序物件。
• 使用條件來指定要在回應中傳回的物件。
• 限制傳回的物件數量。

GoogleAdsService 可以在 兩種方式：

• GoogleAdsService.SearchStream敬上 會傳回單一串流回應中的所有資料列，對 大型 (超過 10,000 列) 結果集。這可能比較適合 如果您希望批次應用程式
• GoogleAdsService.Search 分裂 處理大量回應的結果。 在您的互動式應用程式中顯示結果頁面 讓應用程式從可以最快做出回應的位置 回應使用者要求

進一步瞭解分頁與串流。

提出要求

搜尋方法需要 SearchGoogleAdsRequest，其中包含 以下屬性：

• customer_id
• Google Ads 查詢語言 query，用於指出要查詢的資源、屬性 要擷取的區隔和指標，以及用來限制 哪些物件
• (僅限 GoogleAdsService.Search) A page_size，指出當單一回應中要傳回多少物件 使用分頁。
• (僅限 GoogleAdsService.Search) 採用 視需要使用 page_token，擷取下一批結果 分頁。

如要進一步瞭解 Google Ads 查詢語言，請參閱 Google Ads 查詢語言 指南。

處理回應

GoogleAdsService 會傳回 GoogleAdsRow 物件。

每個 GoogleAdsRow 都代表查詢傳回的物件，並由 系統會根據 SELECT 子句。不符合 SELECT 子句中的屬性 才會填入回應中的 GoogleAdsRow 物件。

舉例來說，雖然 ad_group_criterion 具有 status 屬性， 列中 ad_group_criterion 屬性的 status 欄位未填入 SELECT 子句不包含的查詢回應 ad_group_criterion.status。同樣地，資料列的 campaign 屬性是 如果 SELECT 子句不包含來自 campaign 項資源。

每個GoogleAdsRow可以有來自另一列的屬性和指標 同屬一個結果集；因此資料列應視為 物件 固定的資料列。

UNKNOWN 列舉類型

系統無法完整支援在 UNKNOWN 中傳回類型為 UNKNOWN 的資源 該 API 版本這些資源可能是經由其他 例如 Google Ads UI您可以選取資源 UNKNOWN 的類型，但無法透過 API 變更資源。一個 以使用者介面推出的新廣告活動或廣告為例 不支援您要查詢的 API 版本。

以下是幾點注意事項：

• 日後可以支援使用 UNKNOWN 類型的資源，日後也可使用 UNKNOWN 無限期。
• 類型為 UNKNOWN 的新物件隨時可能顯示。這些物件 因為列舉值已存在，所以可回溯相容。資源 受到這項異動的影響，因此 精確查看帳戶UNKNOWN 資源出現的原因可能是 透過其他介面在帳戶中獲得的新活動 已不支援。
• UNKNOWN 項資源可以附加詳細指標 方便查詢。
• UNKNOWN 資源通常會完整顯示在 Google Ads 使用者介面中。
• UNKNOWN 資源通常無法修改。

區隔

回應會包含 GoogleAdsRow， 包括：

• FROM 子句中指定的主要資源執行個體
• 每個所選segment欄位的值

例如，針對選取 FROM campaign 且 SELECT 子句中的 segments.ad_network_type 和 segments.date 會 而是代表一個資料列，代表下列各項的組合：

• campaign
• segments.ad_network_type
• segments.date

結果是由主要資源的每個執行個體間接區隔，而不是按照 所選個別欄位的值例如：

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

每個廣告活動都會產生一個資料列，而不是每個 campaign.status 欄位。