GoogleAdsService 是統一物件
Google Ads API 的擷取和報表服務。此服務的方法會具有以下特性：
- 擷取物件的特定屬性。
- 依據日期範圍擷取物件的成效指標。
- 按照物件屬性排序物件。
- 使用條件來指定要在回應中傳回的物件。
- 限制傳回的物件數量。
GoogleAdsService 可以在
兩種方式：
GoogleAdsService.SearchStream敬上 會傳回單一串流回應中的所有資料列，對 大型 (超過 10,000 列) 結果集。這可能比較適合 如果您希望批次應用程式GoogleAdsService.Search分裂 處理大量回應的結果。 在您的互動式應用程式中顯示結果頁面 讓應用程式從可以最快做出回應的位置 回應使用者要求
進一步瞭解分頁與串流。
提出要求
搜尋方法需要
SearchGoogleAdsRequest，其中包含
以下屬性：
customer_id- Google Ads 查詢語言
query，用於指出要查詢的資源、屬性 要擷取的區隔和指標，以及用來限制 哪些物件 - (僅限
GoogleAdsService.Search) Apage_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 會
而是代表一個資料列，代表下列各項的組合：
campaignsegments.ad_network_typesegments.date
結果是由主要資源的每個執行個體間接區隔，而不是按照 所選個別欄位的值例如：
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
每個廣告活動都會產生一個資料列，而不是每個
campaign.status 欄位。