摘要
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
建立網站簡介額外資訊
function createSnippet() { // For full details on creating a new snippet extension, see: // https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_snippetbuilder const newSnippet = AdsApp.extensions().newSnippetBuilder() // Replace the values below with your header, values, and mobile preferred // For a list of supported headers, see: https://developers.google.com/adwords/api/docs/appendix/structured-snippet-headers .withHeader('Brands') // required .withValues(['Nest', 'Waymo','Google']) // required .withMobilePreferred(true) // optional .build() .getResult(); // Add snippet to a campaign const campaignIterator = AdsApp.campaigns() .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') .get(); if (campaignIterator.hasNext()) { const campaign = campaignIterator.next(); campaign.addSnippet(newSnippet); } // Add snippet to an ad group const adGroupIterator = AdsApp.adGroups() .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') .withCondition('ad_group.name = "INSERT_AD_GROUP_NAME_HERE"') .get(); if (adGroupIterator.hasNext()) { const adGroup = adGroupIterator.next(); adGroup.addSnippet(newSnippet); } // Add snippet to an account const account = AdsApp.currentAccount(); account.addSnippet(newSnippet); }
記錄廣告活動的程式碼片段詳細資料
function logSnippetDetails() { // Get a campaign. const campaignIterator = AdsApp.campaigns() .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') .get(); if (!campaignIterator.hasNext()) { throw new Error('Campaign not found.'); } const campaign = campaignIterator.next(); // Retrieve the campaign's snippets. Retrieving an ad group's and // account's sniuppets is similar. const snippetIterator = campaign.extensions().snippets().get(); for (const snippet of snippetIterator) { // You can also request reports for pre-defined date ranges. See // https://developers.google.com/adwords/api/docs/guides/awql, // DateRangeLiteral section for possible values. const stats = snippet.getStatsFor('LAST_MONTH'); console.log(`Snippet header : ${ snippet.getHeader() }`); console.log(`Snippet values : ${ snippet.getValues() }`); console.log(`mobile preferred : ${ snippet.isMobilePreferred() }`); console.log(`clicks : ${ stats.getClicks() }`); console.log(`impressions : ${ stats.getImpressions() }`); console.log('======='); } console.log(`${snippetIterator.totalNumEntities()} snippets in the campaign`); }
為廣告活動中的網站簡介設定時段
function setSnippetSchedule() { // Get a campaign. const campaignIterator = AdsApp.campaigns() .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') .get(); if (!campaignIterator.hasNext()) { throw new Error('Campaign not found.'); } const campaign = campaignIterator.next(); // Retrieve the campaign's snippets. Retrieving an ad group's and // account's saitelinks is similar. const snippetIterator = campaign.extensions().snippets().get(); for (const snippet of snippetIterator) { if (snippet.getHeader() === 'Brands') { // Set snippet schedule to run only on Mondays and Tuesdays, 9 AM to // 6 PM. const monday = { dayOfWeek: 'MONDAY', startHour: 9, startMinute: 0, endHour: 18, endMinute: 0 }; const tuesday = { dayOfWeek: 'TUESDAY', startHour: 9, startMinute: 0, endHour: 18, endMinute: 0 }; snippet.setSchedules([monday, tuesday]); break; } } }
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-28 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-28 (世界標準時間)。"],[[["This script provides functionality to create new structured snippets with custom headers and values, and optionally mark them as mobile-preferred."],["It demonstrates how to add these snippets to campaigns, ad groups, or accounts for broader targeting."],["The script allows for retrieving and logging key performance metrics of existing snippets, such as clicks and impressions, over specified durations."],["It includes a feature to set custom schedules for snippets, enabling them to run only during defined days and times."]]],[]]