SearchAds360Row

string

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

customers/{customerId}/adGroups/{adGroupId}

enum (AdGroupStatus)

廣告群組的狀態。

enum (AdGroupType)

廣告群組類型。

enum (AdGroupAdRotationMode)

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

string

這個廣告群組的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。

object (TargetingSetting)

設定指定目標相關功能。

string

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

string

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

string

外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶，例如 Yahoo Japan、Microsoft、百度等。如果是 Google Ads 實體，請改用「adGroup.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」。

string (int64 format)

廣告群組的 ID。

string

廣告群組的名稱。

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

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

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

string

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

string (int64 format)

最高單次點擊出價。如果廣告群組的有效出價策略為「手動單次點擊出價」，系統就會使用這個欄位。如果廣告群組的廣告活動使用組合出價策略，系統會忽略這個欄位，且不適用。

enum (AdGroupEngineStatus)

廣告群組的引擎狀態。

string

網址範本，用於將參數附加至最終到達網址。

object (TargetRestriction)

限制廣告活動或廣告群組觸及範圍的指定維度設定。

enum (TargetingDimension)

這些設定適用的指定目標維度。

boolean

指出是否要限制廣告只根據您為這個指定目標維度選取的條件放送，或是要指定這個指定目標維度的所有值，並根據其他指定目標維度的指定目標放送廣告。值為 true 表示這些條件只會套用出價調整幅度，不會影響指定目標。值為 false 表示這些條件會限制指定目標，並套用出價調整幅度。

string

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

customers/{customerId}/adGroupAds/{adGroupId}~{adId}

enum (AdGroupAdStatus)

廣告的狀態。

object (Ad)

廣告。

string

這個廣告群組廣告的建立時間戳記。日期時間採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。

string

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

string

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

string

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

enum (AdGroupAdEngineStatus)

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

string

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

string

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

customers/{customerId}/ads/{adId}

string

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

object (FinalAppUrl)

如果使用者已安裝特定應用程式，系統會在行動裝置上使用的最終應用程式網址清單。

string

廣告經過所有跨網域重新導向後，可能的最終行動版網址清單。

enum (AdType)

廣告類型。

object (SyntheticContentInfo)

廣告的合成內容資訊。只有特定廣告類型的廣告，才能使用 syntheticContentInfo 欄位更新。

允許的 AdType 值：* HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD

string (int64 format)

廣告編號。

string

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

string

建構最終到達網址時使用的尾碼。

string

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

string

廣告的名稱。這項資訊僅用於識別廣告。不一定要是專屬 ID，也不會影響放送的廣告。

object (SearchAds360TextAdInfo)

文字廣告的相關詳細資料。

object (SearchAds360ExpandedTextAdInfo)

延展型文字廣告的相關詳細資料。延展型文字廣告已淘汰。請改用 SearchAds360ResponsiveSearchAd。

object (SearchAds360ResponsiveSearchAdInfo)

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

object (SearchAds360ProductAdInfo)

產品廣告的相關詳細資料。

object (SearchAds360ExpandedDynamicSearchAdInfo)

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

enum (AppUrlOperatingSystemType)

這個網址指定的作業系統。必填。

string

應用程式深層連結網址。深層連結會指定應用程式中與您想顯示內容相應的位置，格式應為 {scheme}://{host_path}。架構會識別要開啟的應用程式。您可以為應用程式使用以應用程式名稱開頭的自訂配置。主機和路徑會指定應用程式中內容所在的唯一位置。例如：「exampleapp://productid_1234」。必填。

object (SyntheticContentAttestation)

廣告主提供的輸入內容。

object (SyntheticContentAttestation)

Google 系統生成的合成內容相關資訊。

enum (SyntheticContentAttestationStatus)

指出這個來源是否將內容視為合成內容。

enum (SyntheticContentSource)

合成內容認證的來源。

string

廣告標題。

string

廣告內容描述的第一行。

string

廣告說明的第二行。

string

廣告的顯示網址。

string

廣告顯示的行動版網址。

string (int64 format)

廣告的追蹤 ID。

string

廣告標題。

string

廣告的第二個標題。

string

廣告的第三個標題。

string

廣告內容描述的第一行。

string

廣告說明的第二行。

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。

string

以分隔符號附加至 path1 的文字。

string (int64 format)

廣告的追蹤 ID。

object (AdTextAsset)

廣告標題的文字素材資源清單。廣告放送時，系統會從這個清單中選取廣告標題。

object (AdTextAsset)

說明的文字素材資源清單。廣告放送時，系統會從這份清單中選取說明。

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。

string

以分隔符號附加至 path1 的文字。

string (int64 format)

廣告的追蹤 ID。

string

素材資源文字。

string

廣告內容描述的第一行。

string

廣告說明的第二行。

string (int64 format)

廣告的追蹤 ID。

string

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

string

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

string

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

string (int64 format)

擁有有效標籤的客戶 ID。

string

廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式為：customers/{ownerCustomerId}/adGroupAdLabels/{adGroupId}~{adId}~{label_id}

string

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

string

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

string (int64 format)

擁有標籤的客戶 ID。

string

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

customers/{customerId}/adGroupAssets/{adGroupId}~{assetId}~{fieldType}

string

必填。素材資源連結的廣告群組。

string

必填。連結至廣告群組的素材資源。

enum (AssetLinkStatus)

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

string

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

customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

string

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

string

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

enum (AssetSetLinkStatus)

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

string

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

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

string

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

customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId}

number

條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。使用 0 即可選擇不使用裝置類型。

object (DeviceInfo)

裝置條件。

enum (Device)

裝置的類型。

string

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

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}

string

這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。

enum (AdGroupCriterionStatus)

條件的狀態。

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

object (QualityInfo)

有關條件品質的資訊。

enum (CriterionType)

條件類型。

string

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

string

附加至這個廣告群組條件的有效標籤資源名稱。有效標籤是指繼承或直接指派給這個廣告群組條件的標籤。

object (PositionEstimates)

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

string

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

string

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

object (CustomParameter)

用於取代 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中自訂參數標記的對應清單。

string

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

string

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

string (int64 format)

指定條件的 ID。

string

條件所屬的廣告群組。

boolean

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

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

number

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

string (int64 format)

單次點擊出價。

string (int64 format)

有效單次點擊出價。

enum (AdGroupCriterionEngineStatus)

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

string

網址範本，用於將參數附加至最終到達網址。

string

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

object (KeywordInfo)

關鍵字。

object (ListingGroupInfo)

商家資訊群組。

object (AgeRangeInfo)

年齡層。

object (GenderInfo)

性別。

object (UserListInfo)

使用者清單。

object (WebpageInfo)

網頁

object (LocationInfo)

。

integer

品質分數。

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

string (int64 format)

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

string

與參數標記名稱相符的鍵。

string

要替換的值。

enum (KeywordMatchType)

關鍵字的比對類型。

string

關鍵字文字 (最多 80 個半形字元和 10 個字)。

enum (ListingGroupType)

商家資訊群組的類型。

enum (AgeRangeType)

年齡層類型。

enum (GenderType)

性別類型。

string

使用者名單資源名稱。

object (WebpageConditionInfo)

指定網頁的條件或邏輯運算式。評估網頁指定目標時，系統會將網頁指定目標條件清單以 AND 運算子合併。如果條件清單為空白，表示廣告活動網站的所有網頁都是指定目標。

建立作業必須填寫這個欄位，更新作業則不得填寫。

number

網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字，計算出的網站涵蓋率百分比。舉例來說，如果涵蓋範圍傳回 1，表示涵蓋範圍為 100%。這是唯讀欄位。

string

這個參數定義的條件名稱。系統會使用名稱值，識別、排序及篩選這類參數的條件。

建立作業必須填寫這個欄位，更新作業則不得填寫。

enum (WebpageConditionOperand)

網頁指定目標條件的運算元。

enum (WebpageConditionOperator)

網頁指定條件的運算子。

string

網頁指定目標條件的引數。

string

地理目標常數資源名稱。

string

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

string

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

string

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

string (int64 format)

擁有有效標籤的客戶 ID。

string

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

string

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

string

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

string (int64 format)

擁有標籤的客戶 ID。

string

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

string

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

string

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

string (int64 format)

擁有有效標籤的客戶 ID。

string

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

string

標籤所附加的廣告群組。

string

指派給廣告群組的標籤。

string (int64 format)

擁有標籤的客戶 ID。

string

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

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

string

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

customers/{customerId}/assets/{assetId}

enum (AssetType)

資產類型。

string

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

string

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

object (CustomParameter)

用於取代 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中網址自訂參數標記的對應清單。

enum (AssetStatus)

資產狀態。

string

這項資產的建立時間戳記。時間戳記採用客戶時區，格式為「yyyy-MM-dd HH:mm:ss」。

string

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

object (SyntheticContentInfo)

素材資源的合成內容資訊。只有特定類型的素材資源可使用 syntheticContentInfo 欄位更新。

允許的 AssetType 值：* IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

string (int64 format)

資產 ID。

string

素材資源的選用名稱。

string

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

string

網址範本，用於將參數附加至透過並行追蹤放送的到達網頁網址。

enum (AssetEngineStatus)

素材資源的引擎狀態。

object (YoutubeVideoAsset)

YouTube 影片素材資源。

object (ImageAsset)

圖片素材資源。

object (TextAsset)

文字素材資源。

object (UnifiedCalloutAsset)

統一摘要素材資源。

object (UnifiedSitelinkAsset)

統一網站連結素材資源。

object (UnifiedPageFeedAsset)

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

object (MobileAppAsset)

行動應用程式素材資源。

object (UnifiedCallAsset)

統一電話素材資源。

object (CallToActionAsset)

行動號召素材資源。

object (UnifiedLocationAsset)

統一地點素材資源。

string

YouTube 影片標題。

string

YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。

enum (MimeType)

圖片素材資源的 MIME 類型。

object (ImageDimension)

這張圖片原始大小的中繼資料。

string (int64 format)

圖片素材資源的檔案大小 (以位元組為單位)。

string (int64 format)

圖片高度。

string (int64 format)

圖片寬度。

string

傳回具有此高度和寬度的圖片的網址。

string

文字素材資源的文字內容。

string

摘要文字。這個字串的長度應介於 1 到 25 (含首尾)。

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

boolean

是否要在搜尋使用者的時區中顯示資產。適用於 Microsoft Ads。

enum (MinuteOfHour)

這項排程在開始時間的小時過後幾分鐘開始。

建立作業必須填寫這個欄位，更新作業則不得填寫。

enum (MinuteOfHour)

此排程結束時間的小時數之後的分鐘數。排定時間不含最後一分鐘。

建立作業必須填寫這個欄位，更新作業則不得填寫。

enum (DayOfWeek)

時間表適用的星期幾。

建立作業必須填寫這個欄位，更新作業則不得填寫。

integer

開始時間 (24 小時制)。這個欄位必須介於 0 到 23 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。

integer

結束時間 (24 小時制)，24 代表一天結束。這個欄位的值必須介於 0 到 24 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。

string

網站連結的網址顯示文字。這個字串的長度應介於 1 到 25 (含首尾)。

string

網站連結說明的第一行。如要設定，長度必須介於 1 至 35 之間 (含首尾)，且也必須設定 description2。

string

網站連結的第二行說明。如要設定，長度應介於 1 到 35 個字元之間 (含首尾)，且必須同時設定 description1。

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

string (int64 format)

用於追蹤網站連結素材資源點擊的 ID。這是 Yahoo! 僅限日本的欄位。

boolean

是否要在搜尋使用者的時區中顯示網站連結素材資源。適用於 Microsoft Ads。

boolean

偏好在行動裝置上顯示網站連結素材資源。適用於 Microsoft Ads。

string

廣告主想指定的網頁。

string

用來將網頁網址分組的標籤。

string

必填。可唯一識別行動應用程式的字串。其中應只包含平台原生 ID，例如 Android 的「com.android.ebay」或 iOS 的「12345689」。

enum (MobileAppVendor)

必填。發布這個特定應用程式的應用程式商店。

string

電話號碼的雙字母國家/地區代碼。例如「US」、「us」。

string

廣告主的原始電話號碼。範例：「1234567890」、「(123)456-7890」

enum (CallConversionReportingState)

指出這個 CallAsset 應使用自己的來電轉換設定、遵循帳戶層級設定，還是停用來電轉換。

string

要將來電轉換歸因於哪個轉換動作。如未設定，系統會使用預設轉換動作。只有在 callConversionReportingState 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。

object (AdScheduleInfo)

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

boolean

僅限來電廣告是否只顯示電話號碼，而不提供網站連結。適用於 Microsoft Ads。

boolean

是否應啟用通話追蹤功能。適用於 Microsoft Ads。

boolean

是否要在搜尋使用者的時區中顯示來電額外資訊。適用於 Microsoft Ads。

string

這項素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

enum (CallToActionType)

行動號召。