Ad Params
    
    
      
    
    
      
      コレクションでコンテンツを整理
    
    
      
      必要に応じて、コンテンツの保存と分類を行います。
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    
パラメータを使用して広告グループのテキスト広告を作成
function setupAdParamsInAdGroup(adGroupName) {
  // If you have multiple adGroups with the same name, this snippet will
  // pick an arbitrary matching ad group each time. In such cases, just
  // filter on the campaign name as well:
  //
  // AdsApp.adGroups()
  //     .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"')
  //     .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"')
  const adGroupIterator = AdsApp.adGroups()
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroupIterator.hasNext()) {
    throw new Error(`No ad group with name "${adGroupName} found`);
  }
  const adGroup = adGroupIterator.next();
  adGroup.newAd().expandedTextAdBuilder()
      .withHeadlinePart1('Holiday sale')
      .withHeadlinePart2(
          'Starts in {param1: a few} days {param2: and} hours!')
      .withDescription('Everything must go!')
      .withFinalUrl('http://www.example.com/holidaysales')
      .build();
  const keywordIterator = adGroup.keywords().get();
  if (!keywordIterator.hasNext()) {
    console.log(`No keywords found in ad group ${adGroupName}.`);
  } else {
    const keyword = keywordIterator.next();
    // Setup Ad to show as 'Doors open in 5 days, 7 hours!' when searched
    // using this keyword. If the ad is triggered using a keyword
    // without ad param, the ad shows as
    // 'Doors open in a few days, and hours!'
    keyword.setAdParam(1, 5);
    keyword.setAdParam(2, 7);
  }
}
キーワードの広告パラメータを取得
function getAdParamsForKeyword(adGroupName) {
  // If you have multiple adGroups with the same name, this snippet will
  // pick an arbitrary matching ad group each time. In such cases, just
  // filter on the campaign name as well:
  //
  // AdsApp.adGroups()
  //     .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"')
  //     .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"')
  const adGroupIterator = AdsApp.adGroups()
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroupIterator.hasNext()) {
    throw new Error(`No ad group with name "${adGroupName} found`);
  }
  const adGroup = adGroupIterator.next();
  const keywordIterator = adGroup.keywords()
      .withCondition('ad_group_criterion.keyword.text = "Holiday sales"')
      .get();
  if (!keywordIterator.hasNext()) {
    console.log(`No keywords found in ad group ${adGroupName}.`);
  } else {
    const keyword = keywordIterator.next();
    const adParamIterator = keyword.adParams().get();
    for (const adParam of adParamIterator) {
      logAdParam(adParam);
    }
  }
}
function logAdParam(adParam) {
  console.log('Keyword : ' + adParam.getKeyword().getText());
  console.log('MatchType : ' + adParam.getKeyword().getMatchType());
  console.log('Index : ' + adParam.getIndex());
  console.log('Insertion Text : ' + adParam.getInsertionText());
}
  
  
  
  
    
  
 
  
    
    
      
       
    
    
  
  
  特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
  最終更新日 2025-08-21 UTC。
  
  
  
    
      [null,null,["最終更新日 2025-08-21 UTC。"],[],[]]