Package google.ads.searchads360.v0.resources

string

可存取的出價策略資源名稱。AccessibleBiddingStrategy 資源名稱的格式如下：

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

出價策略的 ID。

string

出價策略的名稱。

BiddingStrategyType

出價策略類型。

int64

擁有出價策略的客戶 ID。

string

擁有出價策略的客戶 descriptive_name。

MaximizeConversionValue

自動出價策略，可在預算範圍內為廣告活動爭取最高轉換價值。

MaximizeConversions

這是一種自動出價策略，可在預算範圍內為廣告活動爭取最多轉換。

TargetCpa

這是一種出價策略，可根據您指定的目標單次轉換出價設定出價，盡量爭取轉換。

TargetImpressionShare

自動根據所選曝光百分比進行最佳化調整的出價策略。

TargetRoas

這項出價策略可讓您盡量提高收益，同時將目標廣告投資報酬率 (ROAS) 設為平均值。

TargetSpend

這項出價策略會設定出價，協助您在預算範圍內盡量爭取點擊。

double

目標廣告投資報酬率 (ROAS) 選項。設定後，出價策略會盡量提高收益，同時將目標廣告投資報酬率設為平均值。如果目標廣告投資報酬率過高，出價策略可能無法用盡預算。如果未設定目標廣告投資報酬率，出價策略會盡量以預算達成最高廣告投資報酬率。

int64

目標單次轉換出價 (CPA) 選項。這是您願意為每次轉換支出的平均金額。

int64

目標單次轉換出價 (CPA) 選項。這是您願意為每次轉換支付的平均金額。

int64

平均目標單次轉換出價。這個目標應大於或等於帳戶貨幣的最低可計費單位。

TargetImpressionShareLocation

搜尋結果網頁上的指定位置。

int64

在指定地區顯示廣告的所選百分比 (以微秒為單位)。例如 1% 等於 10,000。

int64

自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位，用於設定上限，並在本地微型廣告中指定。

double

每單位支出所選擇的收益 (根據轉換資料)。

int64

盡量爭取點擊的支出目標。而 TargetSpend 出價方會嘗試以較低的值或自然節流支出金額來支出。如未指定，系統會使用預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

string

廣告的資源名稱。廣告資源名稱的格式如下：

customers/{customer_id}/ads/{ad_id}

string

廣告完成所有跨網域重新導向後，可能會導向的最終到達網址清單。

AdType

廣告類型。

int64

廣告編號。

string

部分廣告格式在廣告說明中顯示的網址。

string

廣告名稱。這項資訊僅用於識別廣告。不必是唯一值，也不會影響放送的廣告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支援名稱欄位。

SearchAds360TextAdInfo

文字廣告的詳細資料。

SearchAds360ExpandedTextAdInfo

延展型文字廣告的詳細資料。

SearchAds360ResponsiveSearchAdInfo

回應式搜尋廣告的詳細資料。

SearchAds360ProductAdInfo

產品廣告的詳細資料。

SearchAds360ExpandedDynamicSearchAdInfo

延展型動態搜尋廣告的詳細資料。

string

廣告群組的資源名稱。廣告群組資源名稱的格式如下：

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

廣告群組的狀態。

AdGroupType

廣告群組類型。

AdGroupAdRotationMode

廣告群組的廣告輪播模式。

string

建立此 ad_group 的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

TargetingSetting

指定目標相關功能的設定。

string

這個廣告群組所附加的標籤資源名稱。

string

附加至這個廣告群組的有效標籤資源名稱。有效標籤是指已沿用或直接指派給這個廣告群組的標籤。

string

外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo! Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group.id」。

string

這個廣告群組開始放送廣告的日期。根據預設，廣告群組會在目前時間或廣告群組的開始日期 (以較晚者為準) 開始放送。如果設定這個欄位，廣告群組就會在指定日期的開始時間 (以客戶的時區為準) 開始放送。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。

格式：YYYY-MM-DD 範例：2019-03-14

string

廣告群組停止放送廣告的日期。根據預設，廣告群組會在廣告群組結束日期結束。如果您設定這個欄位，廣告群組就會在指定日期的結束時間 (以客戶的時區為準) 結束。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。

格式：YYYY-MM-DD 範例：2019-03-14

string

廣告群組中的廣告和關鍵字語言。這個欄位僅適用於 Microsoft Advertising 帳戶。詳情請見：https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

string

這個廣告群組上次修改的日期和時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

int64

廣告群組的 ID。

string

廣告群組的名稱。

這個欄位為必填欄位，建立新廣告群組時不得留空。

長度不得超過 255 個 UTF-8 全形字元。

不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車 (代碼點 0xD) 字元。

int64

最高單次點擊出價。

AdGroupEngineStatus

廣告群組的引擎狀態。

string

廣告的資源名稱。廣告群組廣告資源名稱的格式如下：

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

廣告的狀態。

Ad

廣告。

string

建立此 ad_group_ad 的時間戳記。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

string

這個廣告群組廣告附加的標籤資源名稱。

string

附加至此廣告的有效標籤資源名稱。有效標籤是指沿用或直接指派給廣告的標籤。

string

外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是其他非 Search Ads 360 實體，請改用「ad_group_ad.ad.id」。

AdGroupAdEngineStatus

外部引擎帳戶中的廣告其他狀態。可能的狀態 (視外部帳戶類型而定) 包括有效、符合資格、待審查等。

string

這個廣告群組廣告上次修改的日期和時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

string

廣告群組廣告有效標籤的資源名稱。廣告群組廣告有效標籤資源名稱的格式為：customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

string

有效標籤所附加的廣告群組廣告。

string

指派給廣告群組廣告的有效標籤。

int64

擁有有效標籤的客戶 ID。

string

廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式為：customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

string

標籤所附加的廣告群組廣告。

string

指派給廣告群組廣告的標籤。

int64

擁有標籤的客戶 ID。

string

廣告群組素材資源的資源名稱。AdGroupAsset 資源名稱的格式如下：

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

必要欄位。素材資源連結的廣告群組。

string

必要欄位。連結至廣告群組的素材資源。

AssetLinkStatus

廣告群組素材資源的狀態。

string

廣告群組素材資源集合的資源名稱。廣告群組素材資源集合資源名稱的格式如下：

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

string

這個素材資源集合連結的廣告群組。

string

連結至廣告群組的素材資源集合。

AssetSetLinkStatus

廣告群組素材資源集合的狀態。唯讀。

string

廣告群組目標對象檢視資源名稱。廣告群組目標對象檢視資源名稱的格式為：

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

廣告群組出價調節係數的資源名稱。廣告群組出價調節係數資源名稱的格式如下：

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。PreferredContent 的範圍為 1.0 到 6.0。使用 0 可選擇停用裝置類型。

DeviceInfo

裝置條件。

string

廣告群組條件的資源名稱。廣告群組條件資源名稱的格式如下：

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

string

建立此廣告群組標準的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

AdGroupCriterionStatus

條件的狀態。

這是由用戶端設定的廣告群組條件實體狀態。注意：使用者介面報表可能會納入額外資訊，影響條件是否符合執行資格。在某些情況下，API 中已「移除」的條件仍可能會在 UI 中顯示為已啟用。舉例來說，廣告活動預設會向所有年齡層的使用者放送，除非您排除特定年齡層。由於每個年齡層都符合觀看廣告的資格，因此使用者介面會將每個年齡層顯示為「已啟用」；但由於未新增正面條件，因此 AdGroupCriterion.status 會顯示為「已移除」。

QualityInfo

標準品質相關資訊。

CriterionType

條件類型。

string

附加至這個廣告群組條件的標籤資源名稱。

string

附加至此廣告群組條件的有效標籤資源名稱。有效標籤是指沿用或直接指派給此廣告群組條件的標籤。

PositionEstimates

不同位置的條件出價預估值。

string

廣告完成所有跨網域重新導向後，可能會導向的最終到達網址清單。

string

外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo! Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「ad_group_criterion.criterion_id」。

string

這個廣告群組條件上次修改的日期和時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

int64

指定條件的 ID。

string

條件所屬的廣告群組。

bool

指定 (false) 或排除 (true) 條件。

這個欄位無法變更。如要將準則從正面切換為負面，請先移除再重新新增。

double

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定的條件類型都支援調節項。

int64

單次點擊出價 (CPC)。

int64

有效單次點擊出價。

AdGroupCriterionEngineStatus

廣告群組條件的引擎狀態。

string

用於在最終到達網址中附加參數的網址範本。

string

用於建構追蹤網址的網址範本。

KeywordInfo

關鍵字。

ListingGroupInfo

商家資訊群組。

AgeRangeInfo

年齡層。

GenderInfo

性別。

UserListInfo

使用者名單。

WebpageInfo

網頁

LocationInfo

。

int64

預估的單次點擊出價，可讓廣告顯示在搜尋結果第一頁的頂端。

int32

品質分數。

如果 Google 沒有足夠的資訊來判斷值，就不會填入這個欄位。

string

廣告群組條件有效標籤的資源名稱。廣告群組條件有效標籤資源名稱的格式為：customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

string

有效標籤所附加的廣告群組條件。

string

指派給廣告群組條件的有效標籤。

int64

擁有有效標籤的客戶 ID。

string

廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式為：customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

string

標籤所屬的廣告群組條件。

string

指派給廣告群組條件的標籤。

int64

擁有標籤的客戶 ID。

string

廣告群組有效標籤的資源名稱。廣告群組有效標籤資源名稱的格式為：customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

string

有效標籤所屬的廣告群組。

string

指派給廣告群組的有效標籤。

int64

擁有有效標籤的客戶 ID。

string

廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式為：customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

string

標籤所屬的廣告群組。

string

指派給廣告群組的標籤。

int64

擁有標籤的客戶 ID。

string

年齡範圍檢視畫面的資源名稱。年齡範圍檢視畫面的資源名稱格式如下：

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

素材資源的資源名稱。素材資源名稱的格式如下：

customers/{customer_id}/assets/{asset_id}

AssetType

素材資源類型。

string

所有跨網域重新導向後，可能的最終到達網址清單。

AssetStatus

資產的狀態。

string

此資產的建立時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

string

這項資產上次修改的日期時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

int64

資產 ID。

string

素材資源的選用名稱。

string

用於建構追蹤網址的網址範本。

AssetEngineStatus

素材資源的引擎狀態。

YoutubeVideoAsset

YouTube 影片素材資源。

ImageAsset

圖片素材資源。

TextAsset

文字素材資源。

UnifiedCalloutAsset

統一摘要素材資源。

UnifiedSitelinkAsset

統一網站連結素材資源。

UnifiedPageFeedAsset

統一網頁動態饋給素材資源。

MobileAppAsset

行動應用程式素材資源。

UnifiedCallAsset

統一電話素材資源。

CallToActionAsset

行動號召素材資源。

UnifiedLocationAsset

統一地點素材資源。

string

素材資源群組的資源名稱。素材資源群組資源名稱的格式如下：

customers/{customer_id}/assetGroups/{asset_group_id}

int64

素材資源群組的 ID。

string

這個素材資源群組所關聯的廣告活動。連結至素材資源群組的素材資源。

string

必要欄位。素材資源群組的名稱。必要欄位。長度必須介於 1 到 128 之間。在廣告活動中不得重複。

string

所有跨網域重新導向後的最終到達網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設為可擴展。

string

所有跨網域重新導向後的最終行動版網址清單。在最高成效廣告活動中，除非選擇停用，否則網址預設為可擴展。

AssetGroupStatus

素材資源群組的狀態。

string

文字的第一部分，可能會附加到廣告中顯示的網址。

string

廣告中顯示的網址後方可能會加上的文字。只有在 path1 設值時，才能設定這個欄位。

AdStrength

這個素材資源群組的整體廣告優異度。

string

素材資源群組資源的資源名稱。素材資源群組素材資源名稱的格式如下：

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

這個素材資源群組資產連結的素材資源群組。

string

這個素材資源群組資產連結的素材資源。

AssetFieldType

素材資源在素材資源群組中的刊登位置說明。例如：HEADLINE、YOUTUBE_VIDEO 等

AssetLinkStatus

素材資源與素材資源群組之間的連結狀態。

AssetUsage

已提供的素材資源。

string

素材資源群組商家資訊群組篩選器的資源名稱。素材資源群組商家資訊群組篩選器資源名稱的格式如下：

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

這個素材資源群組商家資訊群組篩選器所屬的素材資源群組。

int64

ListingGroupFilter 的 ID。

ListingGroupFilterType

商家資訊群組篩選器節點的類型。

ListingGroupFilterVertical

目前節點樹狀結構代表的垂直方向。同一個樹狀結構中的所有節點都必須屬於相同的垂直產業。

ListingGroupFilterDimension

這個商家資訊群組用來細分父項的維度值。根群組未定義。

string

父項商家資訊群組子項的資源名稱。根目錄商家資訊群組篩選器節點為空值。

ListingGroupFilterDimensionPath

定義此商家資訊群組篩選器的維度路徑。

string

素材資源群組信號的資源名稱。素材資源群組信號資源名稱的格式如下：

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

string

這個素材資源群組信號所屬的素材資源群組。

AudienceInfo

最高成效廣告活動要使用的目標對象信號。

string

素材資源群組頂級組合檢視畫面的資源名稱。AssetGroup Top Combination 檢視畫面的資源名稱格式為：`"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

AssetGroupAssetCombinationData

一併放送的成效最佳素材資源組合。

int64

素材資源組合 ID。

string

資產集的資源名稱。資產集資源名稱的格式如下：

customers/{customer_id}/assetSets/{asset_set_id}

string

資產集合資產的資源名稱。素材資源集合素材資源名稱的格式如下：

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

這個素材資源組合資產連結到的素材資源組合。

string

這個素材資源組合素材資源連結的素材資源。

AssetSetAssetStatus

素材資源組合資產的狀態。唯讀。

string

目標對象的資源名稱。目標對象名稱的格式如下：

customers/{customer_id}/audiences/{audience_id}

int64

目標對象的 ID。

string

必要欄位。目標對象的名稱。且不得與任何目標對象重複。長度必須介於 1 到 255 之間。

string

這個目標對象的說明。

string

出價策略的資源名稱。出價策略資源名稱的格式如下：

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

出價策略的狀態。

這是唯讀欄位。

BiddingStrategyType

出價策略類型。設定出價企劃書，建立出價策略。

這是唯讀欄位。

string

出價策略使用的貨幣 (ISO 4217 三個字母代碼)。

對於管理員客戶中的出價策略，您可以在建立時設定這個幣別，預設值為管理員客戶的幣別。對於放送客戶，這個欄位無法設定；放送客戶中的所有策略都會隱含使用放送客戶的幣別。無論如何，effective_currency_code 欄位都會傳回策略使用的貨幣。

int64

出價策略的 ID。

string

出價策略的名稱。帳戶中的所有出價策略名稱不得重複。

這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (經過裁剪)。

string

出價策略使用的貨幣 (ISO 4217 三個字母代碼)。

對於管理員客戶的出價策略，這是廣告主建立策略時設定的貨幣。如果是服務客戶，則為客戶的 currency_code。

出價策略指標會以此貨幣回報。

這是唯讀欄位。

int64

附加至這項出價策略的廣告活動數量。

這是唯讀欄位。

int64

附加至這項出價策略的未移除廣告活動數量。

這是唯讀欄位。

EnhancedCpc

這項出價策略會針對較有可能促成轉換的點擊調高出價，針對較不可能促成轉換的點擊調低出價。

MaximizeConversionValue

自動出價策略，可在預算範圍內為廣告活動爭取最高轉換價值。

MaximizeConversions

這是一種自動出價策略，可在預算範圍內為廣告活動爭取最多轉換。

TargetCpa

這是一種出價策略，可根據您指定的目標單次轉換出價設定出價，盡量爭取轉換。

TargetImpressionShare

自動根據所選曝光百分比進行最佳化調整的出價策略。

TargetOutrankShare

這種出價策略會根據競價中廣告主應超越特定競爭對手的目標百分比，設定出價。這個欄位已不適用；使用這個欄位建立新的出價策略，或將含有這個欄位的出價策略附加至廣告活動，都會失敗。但如果策略已填入此配置，則可進行轉換。

TargetRoas

這項出價策略可讓您盡量提高收益，同時將目標廣告投資報酬率 (ROAS) 設為平均值。

TargetSpend

這項出價策略會設定出價，協助您在預算範圍內盡量爭取點擊。

string

廣告活動的資源名稱。廣告活動資源名稱的格式如下：

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

廣告活動的狀態。

新增廣告活動時，狀態預設為「已啟用」。

CampaignServingStatus

廣告活動的廣告放送狀態。

BiddingStrategySystemStatus

廣告活動出價策略的系統狀態。

AdServingOptimizationStatus

廣告活動的廣告放送最佳化狀態。

AdvertisingChannelType

廣告活動中廣告的主要放送目標。您可以在 network_settings 中調整指定目標選項。

這個欄位為必填欄位，建立新廣告活動時不得留空。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。

AdvertisingChannelSubType

可選的 advertising_channel_type 精修項目。必須是父項管道類型的有效子類型。

只能在建立廣告活動時設定。廣告活動建立完成後，就無法變更這個欄位。

CustomParameter

用於在 tracking_url_template、final_urls 或 mobile_final_urls 中替換自訂參數代碼的對應項目清單。

RealTimeBiddingSetting

即時出價設定，這項功能僅適用於指定 Ad Exchange 聯播網的廣告活動。

NetworkSettings

廣告活動的聯播網設定。

DynamicSearchAdsSetting

用於控制動態搜尋廣告 (DSA) 的設定。

ShoppingSetting

用於控制購物廣告活動的設定。

GeoTargetTypeSetting

廣告地理指定目標的設定。

string

附加至這個廣告活動的有效標籤資源名稱。有效標籤是指已沿用或直接指派給這個廣告活動的標籤。

string

附加至這個廣告活動的標籤資源名稱。

BiddingStrategyType

出價策略類型。

您可以設定出價企劃書來建立標準出價策略，也可以設定 bidding_strategy 欄位來建立組合出價策略，藉此建立出價策略。

這是唯讀欄位。

string

AccessibleBiddingStrategy 的資源名稱，這是以「bidding_strategy」識別的附加組合出價策略中，不受限制屬性的唯讀檢視畫面。如果廣告活動未採用組合策略，則為空白。所有共用策略的客戶都能使用無限制策略屬性，這些屬性會從 AccessibleBiddingStrategy 資源讀取。相反地，只有策略擁有者客戶和其管理員可以使用受限制的屬性。受限制的屬性只能從 BiddingStrategy 資源讀取。

FrequencyCapEntry

限制每位使用者看到此廣告活動廣告的頻率。

SelectiveOptimization

這個廣告活動的選擇性最佳化設定，包括一組轉換動作，用於為這個廣告活動進行最佳化。這項功能僅適用於使用「MULTI_CHANNEL」做為 AdvertisingChannelType，以及使用「APP_CAMPAIGN」或「APP_CAMPAIGN_FOR_ENGAGEMENT」做為 AdvertisingChannelSubType 的應用程式廣告活動。

OptimizationGoalSetting

這個廣告活動的最佳化目標設定，包括一組最佳化目標類型。

TrackingSetting

追蹤資訊的廣告活動層級設定。

string

外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo! Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「campaign.id」。

AssetFieldType

這個廣告活動應排除的素材資源欄位類型。此廣告活動不會從上層繼承這些欄位類型的素材資源連結。

string

建立這個廣告活動的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。create_time 會在 v1 中淘汰。請改用 creation_time。

string

建立這個廣告活動的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

string

廣告活動上次修改的日期和時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

int64

廣告活動 ID。

string

廣告活動名稱。

這個欄位為必填欄位，建立新廣告活動時不得留空。

不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車 (代碼點 0xD) 字元。

string

用於建構追蹤網址的網址範本。

string

廣告活動預算的資源名稱。

string

廣告活動在服務對象客戶所在時區開始的日期，格式為 YYYY-MM-DD。

string

以 YYYY-MM-DD 格式顯示的廣告活動結束日，以服務對象所在時區為準。建立廣告活動時，預設為 2037 年 12 月 30 日，表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送，請將這個欄位設為 2037-12-30。

string

尾碼，用於在透過並行追蹤放送的到達網頁中附加查詢參數。

bool

代表已停用網址擴充功能，以便指定更多網址。如果已停用 (值為 true)，系統只會指定素材資源群組中的最終到達網址，或是廣告客戶在 Google Merchant Center 或業務資料動態饋給中指定的網址。如果已選擇加入 (false)，則會指定整個網域。這個欄位只能用於最高成效廣告活動，預設值為 false。

string

廣告活動使用的組合出價策略資源名稱。

ManualCpa

標準手動單次轉換出價策略。手動出價策略，可讓廣告主為廣告主指定的動作設定出價。僅適用於在地生活服務廣告活動。

ManualCpc

標準手動單次點擊出價策略。使用者按次付費的手動點擊出價。

ManualCpm

標準手動千次曝光出價策略。手動曝光出價，使用者以每千次曝光付費。

MaximizeConversions

標準的「盡量爭取轉換」出價策略，可在預算範圍內自動爭取最多轉換。

MaximizeConversionValue

標準「盡量提高轉換價值」出價策略會自動設定出價，在預算範圍內盡量提高收益。

TargetCpa

這是一種標準的目標單次轉換出價策略，可自動設定出價，按您設定的目標單次轉換出價盡量爭取轉換。

TargetImpressionShare

目標曝光比重出價策略。這是一種自動出價策略，可設定出價，以便達到所選曝光百分比。

TargetRoas

標準目標廣告投資報酬率出價策略：自動提高收益，同時平均達到特定目標廣告投資報酬率 (ROAS)。

TargetSpend

這是一種自動出價策略，可在預算範圍內盡量爭取點擊。

PercentCpc

標準單次點擊出價百分比出價策略，出價是某些商品或服務廣告價格的一部分。

TargetCpm

自動最佳化千次曝光出價的出價策略。

string

必要欄位。這個設定代表的網域名稱，例如「google.com」或「www.google.com」。

string

必要欄位。指定網域語言的語言代碼，例如「en」。

bool

廣告活動是否只使用廣告主提供的網址。

PositiveGeoTargetType

這個特定廣告活動用於正向地理指定的設定。

NegativeGeoTargetType

這個特定廣告活動的排除地理區域指定設定。

bool

廣告是否會與 Google.com 搜尋結果一併放送。

bool

廣告是否會在 Google 搜尋聯播網的合作夥伴網站上放送 (需要 target_google_search 也為 true)。

bool

廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置放送。您可以使用「刊登位置」條件指定刊登位置。

bool

廣告是否會在 Google 合作夥伴網路上放送。這項功能僅適用於部分 Google 合作夥伴帳戶。

OptimizationGoalType

最佳化目標類型清單。

string

為這個廣告活動最佳化轉換動作時，所選取的資源名稱組合。

string

要納入廣告活動的產品動態饋給標籤。只能設定一個「動態饋給標籤」或「銷售國家/地區」。如果使用 feed_label 代替 sales_country，則系統會接受相同格式的國家/地區代碼，例如：'XX'。否則可以是任何字串，用於 Google Merchant Center 中的動態饋給標籤。

bool

是否指定車輛商品目錄廣告空間。

int64

Merchant Center 帳戶 ID。這是建立作業的必填欄位。這個欄位無法變更 (購物廣告活動)。

string

要納入廣告活動的產品銷售國家/地區。

int32

廣告活動優先順序。優先順序數字較高的廣告活動會優先於優先順序較低的廣告活動。購物廣告活動必須填入這個欄位，值介於 0 和 2 之間 (含頭尾)。智慧購物廣告活動可選擇使用這個欄位，但如果設定此欄位，則必須設為 3。

bool

是否納入店面產品。

string

用於動態追蹤的網址。

string

廣告活動素材資源的資源名稱。CampaignAsset 資源名稱的格式如下：

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

廣告活動素材資源的狀態。

string

素材資源連結的廣告活動。

string

與廣告活動連結的素材資源。

string

廣告活動素材資源組合的資源名稱。素材資源集合素材資源名稱的格式如下：

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

string

這個素材資源集合連結的廣告活動。

string

與廣告活動連結的素材資源組合。

AssetSetLinkStatus

廣告活動素材資源組合資產的狀態。唯讀。

string

廣告活動目標對象檢視畫面的資源名稱。廣告活動目標對象檢視資源名稱的格式如下：

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

廣告活動預算的資源名稱。廣告活動預算資源名稱的格式如下：

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

BudgetDeliveryMethod

決定廣告活動預算支出速度的放送方式。

如未在建立作業中指定，則預設為 STANDARD。

BudgetPeriod

支出預算的時間範圍。如未指定，預設值為 DAILY。

int64

以帳戶當地幣別計算的預算金額。金額以微量單位表示，其中 1000 萬等於 1 個貨幣單位。每月支出上限為此金額的 30.4 倍。

string

廣告活動條件的資源名稱。廣告活動條件資源名稱的格式如下：

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

條件的顯示名稱。

系統會忽略此欄位。

CriterionType

條件類型。

CampaignCriterionStatus

條件的狀態。

string

上次修改此廣告活動條件的日期和時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

int64

指定條件的 ID。

系統會在變更期間忽略這個欄位。

float

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定的條件類型都支援調節項。使用 0 可選擇停用裝置類型。

bool

指定 (false) 或排除 (true) 條件。

KeywordInfo

關鍵字。

LocationInfo

。

DeviceInfo

裝置。

AgeRangeInfo

年齡層。

GenderInfo

性別。

UserListInfo

使用者名單。

LanguageInfo

語言。

WebpageInfo

網頁。

LocationGroupInfo

地區群組

string

資源名稱。CampaignEffectivelabel 資源名稱的格式為：customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

string

有效標籤所附加的廣告活動。

string

指派給廣告活動的有效標籤。

int64

擁有有效標籤的客戶 ID。

string

資源名稱。廣告活動標籤資源名稱的格式為：customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

string

標籤所屬的廣告活動。

string

指派給廣告活動的標籤。

int64

擁有標籤的客戶 ID。

string

購物車資料銷售檢視畫面的資源名稱。購物車資料銷售檢視畫面資源名稱的格式為：customers/{customer_id}/cartDataSalesView

string

轉換的資源名稱。轉換資源名稱的格式如下：

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

轉換的 ID

int64

Search Ads 360 評估依據 ID。如果值為 0，表示評估標準未歸因。

int64

包含點選產品的 Search Ads 360 商品目錄帳戶 ID。在 Search Ads 360 中連結廣告空間帳戶後，Search Ads 360 就會產生這組 ID。

int64

廣告 ID。如果值為 0，表示廣告未歸因。

string

轉換歸因的造訪活動專屬字串，會以點擊 ID 網址參數的形式傳遞至到達網頁。

int64

轉換歸因於的 Search Ads 360 造訪 ID。

string

對於離線轉換，這是廣告客戶提供的 ID。如果廣告主未指定此 ID，Search Ads 360 就會產生一個。如果是線上轉換，這個欄會等於 ID 欄或 floodlight_order_id 欄，具體取決於廣告主的 Floodlight 指示。

string

點按的產品 ID。

ProductChannel

點選的產品銷售通路：線上或本地。

string

為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。

string

點按店面商品目錄廣告的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。

string

內含點選產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。

AttributionType

轉換歸因於哪項：造訪或關鍵字 + 廣告。

string

轉換事件的時間戳記。

string

上次修改轉換的時間戳記。

string

轉換歸因的造訪時間戳記。

int64

轉換記錄的項目數量，由 qty url 參數決定。廣告主必須負責以動態方式填入參數 (例如轉換中售出的商品數量)，否則系統會將其預設為 1。

int64

轉換事件的調整後收益 (以微毫秒為單位)。這項資訊一律會以放送帳戶的貨幣顯示。

int64

修改 Floodlight 貨幣指示前，與 Floodlight 事件相關聯的原始收益 (以目前報表的貨幣計算)。

string

廣告主為轉換提供的 Floodlight 訂單 ID。

ConversionStatus

轉換的狀態，可以是「已啟用」或「已移除」。

int64

轉換事件期間與之互動的資產 ID。

AssetFieldType

轉換事件的素材資源欄位類型。

string

轉換動作的資源名稱。轉換動作資源名稱的格式如下：

customers/{customer_id}/conversionActions/{conversion_action_id}

string

建立 Floodlight 活動的時間戳記，格式為 ISO 8601。

ConversionActionStatus

這個轉換動作的轉換事件累積狀態。

ConversionActionType

這個轉換動作的類型。

ConversionActionCategory

系統為這個轉換動作回報的轉換類別。

ValueSettings

與這個轉換動作相關聯的轉換事件價值設定。

AttributionModelSettings

與這項轉換動作歸因模式相關的設定。

FloodlightSettings

Floodlight 轉換類型的 Floodlight 設定。

int64

轉換動作的 ID。

string

轉換動作的名稱。

這個欄位為必填欄位，建立新的轉換動作時，請勿將其留空。

bool

如果轉換動作的 primary_for_goal 位元為 false，則無論客戶轉換目標或廣告活動轉換目標為何，轉換動作都無法在所有廣告活動中進行出價。不過，自訂轉換目標不會考量 primary_for_goal，因此如果廣告活動的自訂轉換目標設定為 primary_for_goal = false 轉換動作，該轉換動作仍可設定出價。根據預設，如果未設定，primary_for_goal 會設為 true。在 V9 中，primary_for_goal 只能在建立後透過「update」作業設為 false，因為系統並未將其宣告為選用項目。

string

轉換動作擁有者客戶的資源名稱，如果是系統定義的轉換動作，則為空值。

bool

這個轉換動作是否應納入「client_account_conversions」指標。

bool

這個轉換動作是否應納入「轉換」指標。

int64

從互動 (例如點擊) 到轉換事件之間，最長可能經過的天數。

string

應用程式轉換動作的應用程式 ID。

AttributionModel

這個轉換動作的歸因模式類型。

DataDrivenModelStatus

轉換動作的以數據為準歸因模式狀態。

string

用於報表轉換時識別 Floodlight 活動群組的字串。

string

用於在回報轉換時識別 Floodlight 活動的字串。

int64

DoubleClick Campaign Manager (DCM) 中的 Floodlight 活動 ID。

double

當轉換動作的轉換事件傳送的價值無效、遭禁止或缺少時，或當轉換動作設為一律採用預設值時，要使用的價值。

string

當轉換動作的轉換事件傳送時，如果貨幣代碼無效或缺少，或是轉換動作設為一律使用預設值，系統就會使用這個貨幣代碼。

bool

控制是否使用預設價值和預設貨幣代碼，取代轉換動作轉換事件中指定的價值和貨幣代碼。

string

轉換自訂變數的資源名稱。轉換自訂變數資源名稱的格式如下：

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

轉換自訂變數的 ID。

string

必要欄位。轉換自訂變數的名稱。名稱不得重複。名稱的長度上限為 100 個半形字元。請勿在前後加上多餘的空格。

string

必要欄位。轉換自訂變數的代碼。標記應為不重複的字元，並由「u」字元和緊接在後的數字組成，數字必須小於或等於 100。例如：「u4」。

ConversionCustomVariableStatus

轉換事件累積功能的自訂轉換變數狀態。

string

擁有轉換自訂變數的客戶資源名稱。

ConversionCustomVariableFamily

轉換自訂變數的系列。

ConversionCustomVariableCardinality

轉換自訂變數的基數。

FloodlightConversionCustomVariableInfo

Search Ads 360 Floodlight 轉換自訂變數的欄位。

int64

使用這個轉換自訂變數的自訂欄 ID。

FloodlightVariableType

在 Search Ads 360 中定義的 Floodlight 變數類型。

FloodlightVariableDataType

在 Search Ads 360 中定義的 Floodlight 變數資料類型。

bool

顧客是否已接受顧客數位資料條款。如果使用跨帳戶轉換追蹤，這個值會繼承自管理員。這是唯讀欄位。詳情請參閱 https://support.google.com/adspolicy/answer/7475709。

ConversionTrackingStatus

轉換追蹤狀態。這項資訊會指出顧客是否使用轉換追蹤，以及顧客的轉換追蹤擁有者為何人。如果這位客戶使用跨帳戶轉換追蹤，則傳回的值會根據要求的 login-customer-id 而有所不同。

bool

顧客是否已選擇採用待開發客戶強化轉換功能。如果使用跨帳戶轉換追蹤，這個值會繼承自管理員。這是唯讀欄位。

string

建立及管理轉換的客戶資源名稱。這是唯讀欄位。

int64

這個帳戶使用的轉換追蹤 ID。這個 ID 不會指出客戶是否使用轉換追蹤 (conversion_tracking_status 會指出)。這是唯讀欄位。

int64

客戶管理員的轉換追蹤 ID。顧客選擇啟用轉換追蹤時會設定這個值，且會覆寫 conversion_tracking_id。這個欄位只能透過 Google Ads 使用者介面管理。這是唯讀欄位。

int64

客戶管理員的轉換追蹤 ID。當客戶選擇採用跨帳戶轉換追蹤時，系統就會設定這個值，並覆寫 conversion_tracking_id。

string

自訂欄的資源名稱。自訂欄資源名稱的格式如下：

customers/{customer_id}/customColumns/{custom_column_id}

int64

自訂欄的 ID。

string

使用者定義的自訂欄名稱。

string

使用者定義的自訂欄說明。

CustomColumnValueType

自訂欄的結果值類型。

bool

如果自訂欄參照一或多個屬性，則為「是」。

bool

如果自訂欄參照一或多個指標，則為「是」。

bool

如果自訂欄可用於 SearchAds360Service.Search 和 SearchAds360Service.SearchStream 的查詢，則為 True。

string

這個自訂欄參照的系統欄清單。舉例來說，自訂欄「曝光次數和點擊次數總和」參照了系統欄 {"metrics.clicks", "metrics.impressions"}。

CustomColumnRenderType

系統如何解讀自訂欄的結果值。

string

客戶的資源名稱。客戶資源名稱的格式如下：

customers/{customer_id}

ConversionTrackingSetting

客戶的轉換追蹤設定。

AccountType

引擎帳戶類型，例如 Google Ads、Microsoft Advertising、Yahoo! Japan、百度、Facebook、引擎追蹤等。

DoubleClickCampaignManagerSetting

管理員客戶的 DoubleClick Campaign Manager (DCM) 設定。

AccountStatus

帳戶狀態，例如已啟用、已暫停、已移除等。

string

這位客戶上次修改的日期時間。日期時間以客戶的時區和「yyyy-MM-dd HH:mm:ss.ssssss」格式表示。

string

外部引擎帳戶中的帳戶 ID。

CustomerStatus

客戶的狀態。

string

建立此客戶的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

int64

管理員的客戶 ID。如果值為 0，表示客戶沒有 SA360 管理員。

string

管理員的描述性名稱。

int64

副管理員的客戶 ID。如果值為 0，表示客戶沒有副 SA360 管理員。

string

副管理員的描述性名稱。

int64

關聯管理員的客戶 ID。如果值為 0，表示客戶沒有 SA360 助理管理員。

string

關聯管理員的描述性名稱。

AccountLevelType

客戶的帳戶層級：管理員、副管理員、助理管理員、服務帳戶。

int64

客戶的 ID。

string

客戶的選用描述性名稱 (不重複)。

string

帳戶使用的貨幣。系統支援 ISO 4217 標準中的部分貨幣代碼。

string

客戶的當地時區 ID。

string

用於根據參數建構追蹤網址的網址範本。

string

用於在最終到達網址中附加參數的網址範本。

bool

是否為客戶啟用自動標記功能。

bool

客戶是否為管理員。

string

客戶素材資源的資源名稱。CustomerAsset 資源名稱的格式如下：

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

必要欄位。與客戶相關聯的資產。

AssetLinkStatus

客戶資產的狀態。

string

客戶資產集合的資源名稱。素材資源集合素材資源名稱的格式如下：

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

與客戶相關聯的資產集。

string

此素材資源集合連結的客戶。

AssetSetLinkStatus

客戶素材資源組合素材資源的狀態。唯讀。

string

客戶用戶端的資源名稱。CustomerClient 資源名稱的格式為：customers/{customer_id}/customerClients/{client_customer_id}

string

要求客戶擁有的標籤資源名稱，已套用至用戶端客戶。標籤資源名稱的格式如下：

customers/{customer_id}/labels/{label_id}

CustomerStatus

客戶客戶的狀態。僅供檢視。

string

與指定客戶相關聯的客戶端客戶資源名稱。僅供檢視。

bool

指出是否為隱藏帳戶。

僅供檢視。

int64

指定客戶與客戶端之間的距離。對於自連結，層級值為 0。僅供檢視。

string

用戶端時區的通用區域資料庫 (CLDR) 字串表示法，例如 America/Los_Angeles。僅供檢視。

bool

指出用戶端是否為測試帳戶。僅供檢視。

bool

指出客戶是否為管理員。僅供檢視。

string

用戶端的描述性名稱。僅供檢視。

string

客戶的幣別代碼 (例如「USD」、「EUR」)。僅供檢視。

int64

客戶端客戶的 ID。僅供檢視。

string

資源名稱。CustomerManagerLink 資源名稱的格式為：customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}

ManagerLinkStatus

客戶與管理員之間的連結狀態。

string

與客戶相關聯的管理員客戶。

int64

客戶-管理員連結的 ID。此欄位為唯讀。

string

CustomerManagerLink 建立的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

int64

與此客戶相關聯的 Campaign Manager 廣告主 ID。

int64

與此客戶相關聯的 Campaign Manager 聯播網 ID。

string

與此顧客相關聯的 Campaign Manager 聯播網時區，採用 IANA 時區資料庫格式，例如 America/New_York。

string

動態搜尋廣告搜尋字詞檢視畫面的資源名稱。動態搜尋廣告搜尋字詞檢視資源名稱的格式如下：

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

string

系統為曝光動態選取的到達網頁網址。

這是唯讀欄位。

string

性別檢視畫面的資源名稱。性別檢視資源名稱的格式如下：

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

地理目標常數的資源名稱。地理區域目標常數資源名稱的格式如下：

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

指定地理區域常數狀態。

int64

地理區域目標常數的 ID。

string

地理區域常數英文名稱。

string

與目標相關的 ISO-3166-1 alpha-2 國家/地區代碼。

string

指定地理區域常數目標類型。

string

完整英文名稱，包含目標本身的名稱，以及父項和國家/地區的名稱。

string

父項地理區域目標常數的資源名稱。地理區域目標常數資源名稱的格式如下：

geoTargetConstants/{parent_geo_target_constant_id}

string

關鍵字檢視畫面的資源名稱。關鍵字檢視畫面的資源名稱格式如下：

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

資源名稱。標籤資源名稱的格式為：customers/{customer_id}/labels/{label_id}

LabelStatus

標籤狀態。僅供檢視。

TextLabel

在彩色背景上顯示文字的標籤類型。

int64

標籤的 ID。僅供檢視。

string

標籤的名稱。

這個欄位為必填欄位，建立新標籤時不得留空。

這個字串的長度應介於 1 至 80 個半形字元之間 (含首尾)。

string

語言常數的資源名稱。語言常數資源名稱的格式如下：

languageConstants/{criterion_id}

int64

語言常數的 ID。

string

語言代碼，例如「en_US」、「en_AU」、「es」、「fr」等。

string

語言的英文全名，例如「English (US)」、「Spanish」等。

bool

指定語言是否可供指定。

ProductBiddingCategory

產品報價的出價類別。

ProductBrand

產品優惠的品牌。

ProductChannel

產品的地區。

ProductCondition

產品商品的狀況。

ProductCustomAttribute

產品報價的自訂屬性。

ProductItemId

產品方案的商品 ID。

ProductType

產品優惠的類型。

ListingGroupFilterBiddingCategoryLevel

指出分類法中的類別層級。

int64

產品出價類別的 ID。

這個 ID 等同於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436

string

產品品牌的字串值。

ListingGroupFilterProductChannel

區域值。

ListingGroupFilterProductCondition

條件的值。

ListingGroupFilterCustomAttributeIndex

表示自訂屬性的索引。

string

產品自訂屬性的字串值。

string

ID 的值。

ListingGroupFilterProductTypeLevel

類型的層級。

string

值的類型。

ListingGroupFilterDimension

透過商家資訊群組篩選器階層 (不含根節點) 到這個商家資訊群組篩選器的完整維度路徑。

string

位置檢視畫面的資源名稱。位置檢視畫面的資源名稱格式如下：

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

產品出價類別的資源名稱。產品出價類別資源名稱的格式如下：

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

產品出價類別的層級。

ProductBiddingCategoryStatus

產品出價類別的狀態。

int64

產品出價類別的 ID。

這個 ID 等同於本文所述的 google_product_category ID：https://support.google.com/merchants/answer/6324436。

string

產品出價類別的兩個大寫字母國家/地區代碼。

string

父項產品出價類別的資源名稱。

string

產品出價類別的語言代碼。

string

根據 language_code 本地化的產品出價類別顯示值。

string

產品群組檢視畫面的資源名稱。產品群組檢視畫面的資源名稱格式如下：

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

構件資源名稱。構件資源名稱的格式如下：

SearchAds360Fields/{name}

SearchAds360FieldCategory

構件類別。

string

所有資源、區隔和指標的名稱，可透過所述構件選取。

string

所有可透過所述構件選取的資源名稱。當這些資源的欄位納入搜尋查詢時，不會區隔指標。

這個欄位只會針對類別為 RESOURCE 的構件設定。

string

當所述構件用於 FROM 子句時，這個欄位會列出可透過該構件選取的所有指標名稱。只有類別為 RESOURCE 的構件才會設定此屬性。

string

這個欄位會列出所有成果的名稱 (無論是區隔或其他資源)，當區隔指標包含在搜尋查詢中，以及當所述成果在 FROM 子句中使用時，就會列出這些名稱。只有類別為 RESOURCE 的構件會設定此屬性。

string

如果產物是 ENUM 類型的欄位，則可假設的值。

這個欄位僅會針對「SEGMENT」或「ATTRIBUTE」類別的構件設定。

SearchAds360FieldDataType

這個欄位會決定可在 WHERE 子句中與遺跡搭配使用的運算子。

string

構件名稱。

bool

是否可以在搜尋查詢的 SELECT 子句中使用構件。

bool

構件是否可用於搜尋查詢的 WHERE 子句。

bool

是否可以在搜尋查詢的 ORDER BY 子句中使用構件。

string

描述構件資料類型的 Proto 網址。

bool

欄位構件是否重複。

string

購物廣告活動成效檢視畫面的資源名稱。購物廣告活動成效檢視畫面的資源名稱格式為：customers/{customer_id}/shoppingPerformanceView

string

使用者清單的資源名稱。使用者名單資源名稱的格式如下：

customers/{customer_id}/userLists/{user_list_id}

UserListType

清單的類型。

這是唯讀欄位。

int64

使用者名單 ID。

string

這個使用者清單的名稱。視 access_reason 而定，使用者清單名稱可能不是唯一的 (例如，如果 access_reason=SHARED)

string

使用者位置檢視畫面的資源名稱。UserLocation 檢視畫面的資源名稱格式如下：

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

國家/地區的條件 ID。

bool

指出是否指定地點。

string

造訪的資源名稱。訪問資源名稱的格式如下：

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

造訪的 ID。

int64

Search Ads 360 關鍵字 ID。如果值為 0，表示關鍵字未歸因。

int64

包含點選產品的 Search Ads 360 商品目錄帳戶 ID。在 Search Ads 360 中連結廣告空間帳戶後，Search Ads 360 就會產生這組 ID。

int64

廣告 ID。如果值為 0，表示廣告未歸因。

string

每個造訪的專屬字串，會以點擊 ID 網址參數的形式傳遞至到達網頁。

string

造訪事件的時間戳記。時間戳記以客戶的時區和「yyyy-MM-dd HH:mm:ss」格式表示。

string

點按的產品 ID。

ProductChannel

點選的產品銷售通路：線上或本地。

string

為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。

string

點按店面商品目錄廣告的商店。這組 ID 必須與店面產品動態饋給中使用的商店 ID 相符。

string

內含點選產品的商品目錄動態饋給所註冊的國家/地區 (ISO-3166 格式)。

int64

在造訪事件期間與使用者互動的素材資源 ID。

AssetFieldType

造訪事件的素材資源欄位類型。

string

網頁檢視畫面的資源名稱。網頁檢視資源名稱的格式如下：

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}