Package google.ads.searchads360.v0.resources

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

出價策略的 ID。

string

出價策略的名稱。

BiddingStrategyType

出價策略的類型。

int64

擁有出價策略的客戶 ID。

string

description_name 做為出價策略擁有的客戶。

MaximizeConversionValue

自動出價策略，善用你的預算為廣告活動爭取最高轉換價值。

MaximizeConversions

一種自動出價策略，可善用你的預算為廣告活動爭取最多轉換。

TargetCpa

這項出價策略會根據您指定的目標單次轉換出價盡量爭取轉換。

TargetImpressionShare

這類出價策略會根據指定的曝光百分比自動進行最佳化。

TargetRoas

一種出價策略，可在計算特定目標廣告投資報酬率的同時，盡可能提高收益。

TargetSpend

這個出價策略可設定出價，在您的預算範圍內盡量爭取點擊。

double

「目標廣告投資報酬率」選項。如果設定這項策略，出價策略會在計算目標廣告投資報酬率的同時，盡可能提高收益。如果目標廣告投資報酬率偏高，出價策略可能無法支出所有預算。如未設定目標廣告投資報酬率，出價策略會在預算範圍內盡可能爭取最高的廣告投資報酬率。

int64

目標單次轉換出價選項。這是指您願意為每次客戶開發支付的平均金額。

int64

目標單次轉換出價選項。這是指您願意為每次客戶開發支付的平均金額。

int64

平均單次轉換出價目標。這個目標必須大於或等於可計費單位的最低金額 (視帳戶貨幣而定)。

TargetImpressionShareLocation

搜尋結果網頁上的目標地區。

int64

選擇要在目標地區顯示的廣告部分 (以微量為單位)。例如，1% 等於 10,000。

int64

自動出價系統可以指定的最高單次點擊出價。這是廣告客戶輸入的必填欄位，用於設定上限值，並指定以當地微量為單位。

double

每單位支出的指定收益 (根據轉換資料計算)。

int64

盡量爭取點擊的支出目標。目標支出出價工具會嘗試花費金額低於這個值或自然節流支出金額。如未指定，系統會將預算設為支出目標。這個欄位已淘汰，因此不應使用。詳情請參閱 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

外部引擎帳戶中的廣告群組 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.sssss」格式。

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.sssss」格式。

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.sssss」格式。

string

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

string

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

string

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

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 中「已移除」的條件仍能在使用者介面中顯示為已啟用。舉例來說，廣告活動預設會向所有年齡層的使用者顯示 (除非已排除)。使用者介面會將每個年齡層顯示為「已啟用」，因為他們有資格看到廣告；但由於未新增任何肯定條件，AdGroupCriterion.status 將會顯示「已移除」。

QualityInfo

該標準品質的相關資訊。

CriterionType

條件類型。

string

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

PositionEstimates

不同位置的標準出價估算值。

string

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

string

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

string

上次修改此廣告群組條件的日期。日期時間以客戶的時區為準，日期為「yyyy-MM-dd HH:mm:ss.sssss」格式。

int64

條件的 ID。

string

條件所屬的廣告群組。

bool

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

這個欄位無法變更。若要將條件從肯定改為排除，請移除條件並重新新增。

double

條件符合時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。

int64

單次點擊出價。

int64

有效單次點擊出價。

AdGroupCriterionEngineStatus

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

string

可將參數附加至最終到達網址的網址範本。

string

用來建立追蹤網址的網址範本。

KeywordInfo

關鍵字。

ListingGroupInfo

商家資訊群組。

AgeRangeInfo

年齡層。

GenderInfo

性別。

UserListInfo

使用者名單。

WebpageInfo

網頁

LocationInfo

。

int64

這是指廣告顯示在搜尋結果第一頁的頂端所需的預估單次點擊出價。

int32

品質分數。

如果 Google 擁有的資訊不足以判定特定值，則可能不會填入這個欄位。

string

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

string

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

string

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

string

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

string

附加標籤的廣告群組。

string

指派給廣告群組的標籤。

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.sssss」格式。

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 個字元之間。在廣告活動中，ID 不得重複。

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

素材資源群組熱門組合檢視畫面的資源名稱。資產群組頂端組合檢視畫面資源名稱的格式為「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

一種出價策略，可在計算特定目標廣告投資報酬率的同時，盡可能提高收益。

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

用來控管動態搜尋廣告的設定。

ShoppingSetting

用來控管購物廣告活動的設定。

GeoTargetTypeSetting

廣告指定地理區域的設定。

string

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

BiddingStrategyType

出價策略的類型。

設定出價策略時，您可設定出價策略來建立標準出價策略，或是使用「bidding_strategy」欄位建立組合出價策略。

這是唯讀欄位。

string

AccessibleBiddingStrategy 的資源名稱，是以「bidding_strategy」識別的附加組合出價策略中未受限的屬性的唯讀檢視畫面。如果廣告活動沒有使用組合策略，則為空白。所有共用策略的客戶都能使用未設限策略屬性，且可從 AccessibleBiddingStrategy 資源讀取資料。而受限屬性僅供策略的擁有者客戶及其管理員使用。受限制的屬性只能從 BiddingStrategy 資源讀取。

FrequencyCapEntry

這份清單，用來限制這個廣告活動中的廣告向每位使用者顯示的頻率。

SelectiveOptimization

這個廣告活動的選擇性最佳化設定，包含一組轉換動作，可用來最佳化這個廣告活動。這項功能僅適用於採用 MULTI_CHANNEL 做為 AdvertisingChannelType，並以 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 將於第 1 版中淘汰。請改用 create_time。

string

這個廣告活動的建立時間戳記。時間戳記會以客戶所在的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。格式。

string

上次修改這個廣告活動的日期。日期時間以客戶的時區為準，日期為「yyyy-MM-dd HH:mm:ss.sssss」格式。

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

標準目標廣告投資報酬率出價策略，會自動盡可能提高收益，同時計算指定的目標廣告投資報酬率。

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。如果不是 sales_country，則 feed_label 欄位可接受採用相同格式的國家/地區代碼，例如「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

帳戶的預算金額，以帳戶當地幣別顯示。金額以微量為單位，其中一百萬等於一個貨幣單位。每月支出上限為這個金額的 30.4 倍。

string

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

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

string

條件的顯示名稱。

如果是 muts，系統會忽略這個欄位。

CriterionType

條件類型。

CampaignCriterionStatus

條件的狀態。

string

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

int64

條件的 ID。

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

float

條件符合時的出價修飾符。修飾符的範圍必須介於 0.1 至 10.0 之間。大多數可指定的條件類型都支援修飾符。輸入 0 即可停用特定裝置類型。

bool

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

KeywordInfo

關鍵字。

LocationInfo

。

DeviceInfo

Device.

AgeRangeInfo

年齡層。

GenderInfo

性別。

UserListInfo

使用者名單。

LanguageInfo

語言。

WebpageInfo

網頁。

LocationGroupInfo

地區群組

string

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

string

附加標籤的廣告活動。

string

指派給廣告活動的標籤。

string

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

string

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

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

int64

轉換的 ID

int64

Search Ads 360 條件編號。如果值為 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 指示而定，這個欄位會等於 id 欄或 Flolight_order_id 欄。

string

所點選產品的 ID。

ProductChannel

獲得點擊的產品銷售通路：線上或本地。

string

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

string

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

string

針對使用者點選的產品所屬的商品目錄動態饋給，註冊的國家/地區 (ISO-3166 格式)。

AttributionType

轉換的歸因對象：「造訪」或「關鍵字 + 廣告」。

string

轉換事件的時間戳記。

string

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

string

促成轉換的造訪時間戳記。

int64

轉換所記錄的項目數量 (由 qty 網址參數決定)。廣告客戶必須負責以動態方式填入參數 (例如轉換中的售出商品數量)，否則預設值為 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 才能設為 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

如果自訂欄參照一或多項屬性，則為 True。

bool

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

bool

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

string

此自訂欄的參照系統欄清單。例如：自訂資料欄「曝光和點擊總數」已參照 {"metrics.clicks", "metrics.impressions"} 的系統欄。

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.sssss」格式。

string

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

CustomerStatus

客戶的狀態。

string

這位客戶的建立時間戳記。時間戳記會以客戶所在的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。格式。

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

客戶用戶端的資源名稱。客戶資源名稱的格式為：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

英文全名，例如「英文 (美國)」、「西班牙文」等。

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

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

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

int64

造訪的 ID。

int64

Search Ads 360 關鍵字編號。如果值為 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}