新版 Search Ads 360 Reporting API 現已開放使用。歡迎加入 searchads-api-announcements Google 群組，即時掌握即將發布的強化項目和版本資訊。

本頁面由 Cloud Translation API 翻譯而成。

資產

素材資源是廣告的一部分，可在多則廣告間共用。可以是圖片 (ImageAsset)、影片 (YouTubeVideoAsset) 等。素材資源無法變更且無法移除。如要停止放送素材資源，請將素材資源從正在使用素材資源的實體中移除。

歸因資源
客戶

您可以在 SELECT 和 WHERE 子句中，選取上述資源中的欄位與這項資源。這些欄位不會區隔 SELECT 子句中的指標。

asset.call_asset.ad_schedule_targets
欄位說明	不重疊的時間表清單，用於指定資產可放送的所有時間間隔。每天最多只能設定 6 個排程，總共 42 個。
類別	`ATTRIBUTE`
資料類型	`MESSAGE`
輸入網址	`google.ads.searchads360.v0.common.AdScheduleInfo`
是否可篩選	false
可選取	對
可排序	false
重複	對

asset.call_asset.call_conversion_action
欄位說明	要歸因來電轉換的轉換動作。如未設定，系統會使用預設轉換動作。只有在 Call_conversion_reporting_state 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。
類別	`ATTRIBUTE`
資料類型	`RESOURCE_NAME`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.call_conversion_reporting_state
欄位說明	指出此 CallAsset 是否要使用自己的來電轉換設定、追蹤帳戶層級設定，或是停用來電轉換。
類別	`ATTRIBUTE`
資料類型	`ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION`
輸入網址	`google.ads.searchads360.v0.enums.CallConversionReportingStateEnum.CallConversionReportingState`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.call_only
欄位說明	來電是否只顯示電話號碼，而非網站連結。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.call_tracking_enabled
欄位說明	是否應啟用來電追蹤。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.country_code
欄位說明	電話號碼的雙字母國家/地區代碼。例如：「US」、「us」。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.end_date
欄位說明	這個素材資源有效並順利放送的最後日期，格式為 yyyy-MM-dd。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.phone_number
欄位說明	廣告客戶的原始電話號碼。範例：「1234567890」、「(123)456-7890」
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.start_date
欄位說明	這個素材資源的生效日期，會以 yyyy-MM-dd 格式開始放送。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_asset.use_searcher_time_zone
欄位說明	是否要在搜尋使用者的時區中顯示來電額外資訊。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.call_to_action_asset.call_to_action
欄位說明	行動號召。
類別	`ATTRIBUTE`
資料類型	`ENUM APPLY_NOW BOOK_NOW BUY_NOW CONTACT_US DONATE_NOW DOWNLOAD GET_QUOTE LEARN_MORE ORDER_NOW PLAY_NOW SEE_MORE SHOP_NOW SIGN_UP START_NOW SUBSCRIBE UNKNOWN UNSPECIFIED VISIT_SITE WATCH_NOW`
輸入網址	`google.ads.searchads360.v0.enums.CallToActionTypeEnum.CallToActionType`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.callout_asset.ad_schedule_targets
欄位說明	不重疊的時間表清單，用於指定資產可放送的所有時間間隔。每天最多只能設定 6 個排程，總共 42 個。
類別	`ATTRIBUTE`
資料類型	`MESSAGE`
輸入網址	`google.ads.searchads360.v0.common.AdScheduleInfo`
是否可篩選	false
可選取	對
可排序	false
重複	對

asset.callout_asset.callout_text
欄位說明	摘要文字。此字串長度必須介於 1 到 25 (含) 之間。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.callout_asset.end_date
欄位說明	這個素材資源有效並順利放送的最後日期，格式為 yyyy-MM-dd。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.callout_asset.start_date
欄位說明	這個素材資源的生效日期，會以 yyyy-MM-dd 格式開始放送。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.callout_asset.use_searcher_time_zone
欄位說明	是否要以搜尋使用者的時區顯示資產。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.creation_time
欄位說明	建立這個資產的時間戳記。時間戳記是以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss」。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.engine_status
欄位說明	資產的引擎狀態。
類別	`ATTRIBUTE`
資料類型	`ENUM DISABLED DISAPPROVED REMOVED SERVING SERVING_LIMITED UNKNOWN UNSPECIFIED`
輸入網址	`google.ads.searchads360.v0.enums.AssetEngineStatusEnum.AssetEngineStatus`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.final_urls
欄位說明	所有跨網域重新導向後方的可能最終到達網址清單。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	false
重複	對

asset.id
欄位說明	資產 ID。
類別	`ATTRIBUTE`
資料類型	`INT64`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.image_asset.file_size
欄位說明	圖片素材資源的檔案大小，以位元組為單位。
類別	`ATTRIBUTE`
資料類型	`INT64`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.image_asset.full_size.height_pixels
欄位說明	圖片的高度。
類別	`ATTRIBUTE`
資料類型	`INT64`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.image_asset.full_size.url
欄位說明	網址，可傳回此圖片的高度和寬度。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.image_asset.full_size.width_pixels
欄位說明	圖片寬度。
類別	`ATTRIBUTE`
資料類型	`INT64`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.image_asset.mime_type
欄位說明	圖片素材資源的 MIME 類型。
類別	`ATTRIBUTE`
資料類型	`ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED`
輸入網址	`google.ads.searchads360.v0.enums.MimeTypeEnum.MimeType`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.last_modified_time
欄位說明	此素材資源上次修改的日期時間。日期時間會以客戶的時區為準，格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.location_asset.business_profile_locations
欄位說明	客戶的商家所在地點清單。只有從商家檔案帳戶同步處理地點素材資源時，才會傳回這項錯誤。在同一個帳戶底下，有多筆商家檔案資訊指向同一個地點 ID。
類別	`ATTRIBUTE`
資料類型	`MESSAGE`
輸入網址	`google.ads.searchads360.v0.common.BusinessProfileLocation`
是否可篩選	false
可選取	對
可排序	false
重複	對

asset.location_asset.location_ownership_type
欄位說明	地點擁有權的類型，如果類型是 BUSINESS_OWNER，則會以地點額外資訊的形式放送。如果類型為「聯盟」，則會做為經銷地點使用。
類別	`ATTRIBUTE`
資料類型	`ENUM AFFILIATE BUSINESS_OWNER UNKNOWN UNSPECIFIED`
輸入網址	`google.ads.searchads360.v0.enums.LocationOwnershipTypeEnum.LocationOwnershipType`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.location_asset.place_id
欄位說明	地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。對特定客戶 ID 和素材資源類型來說，此為專用欄位。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解地點 ID。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.mobile_app_asset.app_id
欄位說明	必要欄位。專門用於識別行動應用程式的字串。當中應包含平台原生 ID，例如「com.android.ebay」(Android 適用) 或「12345689」(iOS)。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.mobile_app_asset.app_store
欄位說明	必要欄位。發行此特定應用程式的應用程式商店。
類別	`ATTRIBUTE`
資料類型	`ENUM APPLE_APP_STORE GOOGLE_APP_STORE UNKNOWN UNSPECIFIED`
輸入網址	`google.ads.searchads360.v0.enums.MobileAppVendorEnum.MobileAppVendor`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.name
欄位說明	資產的選填名稱。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.page_feed_asset.labels
欄位說明	用於將網頁網址分組的標籤。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	false
重複	對

asset.page_feed_asset.page_url
欄位說明	廣告客戶指定的網頁。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.resource_name
欄位說明	資產的資源名稱。資產資源名稱的格式為：`customers/{customer_id}/assets/{asset_id}`
類別	`ATTRIBUTE`
資料類型	`RESOURCE_NAME`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	false
重複	false

asset.sitelink_asset.ad_schedule_targets
欄位說明	不重疊的時間表清單，用於指定資產可放送的所有時間間隔。每天最多只能設定 6 個排程，總共 42 個。
類別	`ATTRIBUTE`
資料類型	`MESSAGE`
輸入網址	`google.ads.searchads360.v0.common.AdScheduleInfo`
是否可篩選	false
可選取	對
可排序	false
重複	對

asset.sitelink_asset.description1
欄位說明	網站連結說明的第一行。設定後，長度必須介於 1 到 35 (含) 之間，且 description2 長度也必須設定。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.description2
欄位說明	網站連結說明的第二行。設定後，長度必須介於 1 到 35 (含) 之間 (含說明) 且必須設定 description1。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.end_date
欄位說明	這個素材資源有效並順利放送的最後日期，格式為 yyyy-MM-dd。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.link_text
欄位說明	網站連結的網址顯示文字。此字串長度必須介於 1 到 25 (含) 之間。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.mobile_preferred
欄位說明	是否要在行動裝置上顯示網站連結素材資源的偏好設定。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.start_date
欄位說明	這個素材資源的生效日期，會以 yyyy-MM-dd 格式開始放送。
類別	`ATTRIBUTE`
資料類型	`DATE`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.tracking_id
欄位說明	用於追蹤網站連結素材資源點擊的 ID。這是 Yahoo!欄位。
類別	`ATTRIBUTE`
資料類型	`INT64`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.sitelink_asset.use_searcher_time_zone
欄位說明	是否要以搜尋使用者的時區顯示網站連結素材資源。適用於 Microsoft Ads。
類別	`ATTRIBUTE`
資料類型	`BOOLEAN`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.status
欄位說明	資產的狀態。
類別	`ATTRIBUTE`
資料類型	`ENUM ARCHIVED ENABLED PENDING_SYSTEM_GENERATED REMOVED UNKNOWN UNSPECIFIED`
輸入網址	`google.ads.searchads360.v0.enums.AssetStatusEnum.AssetStatus`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.text_asset.text
欄位說明	文字素材資源的文字內容。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.tracking_url_template
欄位說明	用來建構追蹤網址的網址範本。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.type
欄位說明	資產類型。
類別	`ATTRIBUTE`
資料類型	`ENUM BOOK_ON_GOOGLE CALL CALLOUT CALL_TO_ACTION DISCOVERY_CAROUSEL_CARD DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHTS DYNAMIC_HOTELS_AND_RENTALS DYNAMIC_JOBS DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL HOTEL_CALLOUT HOTEL_PROPERTY IMAGE LEAD_FORM LOCATION MEDIA_BUNDLE MOBILE_APP PAGE_FEED PRICE PROMOTION SITELINK STRUCTURED_SNIPPET TEXT UNKNOWN UNSPECIFIED YOUTUBE_VIDEO`
輸入網址	`google.ads.searchads360.v0.enums.AssetTypeEnum.AssetType`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.youtube_video_asset.youtube_video_id
欄位說明	YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

asset.youtube_video_asset.youtube_video_title
欄位說明	YouTube 影片標題。
類別	`ATTRIBUTE`
資料類型	`STRING`
輸入網址	`N/A`
是否可篩選	對
可選取	對
可排序	對
重複	false

資產

asset.call_asset.ad_schedule_targets

asset.call_asset.call_conversion_action

asset.call_asset.call_conversion_reporting_state

asset.call_asset.call_only

asset.call_asset.call_tracking_enabled

asset.call_asset.country_code

asset.call_asset.end_date

asset.call_asset.phone_number

asset.call_asset.start_date

asset.call_asset.use_searcher_time_zone

asset.call_to_action_asset.call_to_action

asset.callout_asset.ad_schedule_targets

asset.callout_asset.callout_text

asset.callout_asset.end_date

asset.callout_asset.start_date

asset.callout_asset.use_searcher_time_zone

asset.creation_time

asset.engine_status

asset.final_urls

asset.id

asset.image_asset.file_size

asset.image_asset.full_size.height_pixels

asset.image_asset.full_size.url

asset.image_asset.full_size.width_pixels

asset.image_asset.mime_type

asset.last_modified_time

asset.location_asset.business_profile_locations

asset.location_asset.location_ownership_type

asset.location_asset.place_id

asset.mobile_app_asset.app_id

asset.mobile_app_asset.app_store

asset.name

asset.page_feed_asset.labels

asset.page_feed_asset.page_url

asset.resource_name

asset.sitelink_asset.ad_schedule_targets

asset.sitelink_asset.description1

asset.sitelink_asset.description2

asset.sitelink_asset.end_date

asset.sitelink_asset.link_text

asset.sitelink_asset.mobile_preferred

asset.sitelink_asset.start_date

asset.sitelink_asset.tracking_id

asset.sitelink_asset.use_searcher_time_zone

asset.status

asset.text_asset.text

asset.tracking_url_template

asset.type

asset.youtube_video_asset.youtube_video_id

asset.youtube_video_asset.youtube_video_title