SearchAds360Row

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}

string

광고 그룹의 리소스 이름입니다. 광고그룹 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroups/{ad_group_id}

enum (AdGroupStatus)

광고 그룹의 상태입니다.

enum (AdGroupType)

광고 그룹의 유형입니다.

enum (AdGroupAdRotationMode)

광고그룹의 광고 로테이션 모드입니다.

string

이 광고그룹이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

object (TargetingSetting)

관련 기능을 타겟팅하기 위한 설정입니다.

string

이 광고 그룹에 연결된 라벨의 리소스 이름입니다.

string

외부 엔진 계정의 광고 그룹 ID입니다. 이 입력란은 Google Ads 이외의 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 사용됩니다. 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 전체 너비 문자를 포함해야 합니다.

null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

string (int64 format)

최대 CPC(클릭당비용) 입찰가입니다.

enum (AdGroupEngineStatus)

광고그룹의 엔진 상태입니다.

{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}

object (TargetRestriction)

캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.

{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}

enum (TargetingDimension)

이 설정이 적용되는 타겟팅 측정기준입니다.

boolean

이 타겟팅 측정기준에 대해 선택한 기준에 대해서만 광고가 게재되도록 제한할지, 이 타겟팅 측정기준의 모든 값을 타겟팅하고 다른 타겟팅 측정기준의 타겟팅을 기반으로 광고를 표시할지 여부를 나타냅니다. 값이 true이면 이러한 기준은 입찰가 조정만 적용하고 타겟팅에는 영향을 미치지 않습니다. 값이 false이면 이러한 기준이 타겟팅을 제한하고 입찰가 조정을 적용한다는 의미입니다.

{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}

string

광고의 리소스 이름입니다. 광고그룹 광고 리소스 이름의 형식은 다음과 같습니다.

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

enum (AdGroupAdStatus)

광고의 상태입니다.

object (Ad)

광고

string

이 adGroupAd가 생성된 타임스탬프입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

string

이 광고 그룹 광고에 연결된 라벨의 리소스 이름입니다.

string

외부 엔진 계정의 광고 ID입니다. 이 입력란은 Search Ads 360 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 해당합니다. Search Ads 360 법인이 아닌 경우 'adGroupAd.ad.id'를 사용하세요. 하세요.

enum (AdGroupAdEngineStatus)

외부 엔진 계정에 있는 광고의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 활성, 적격, 검토 대기중 등입니다.

string

이 광고 그룹 광고가 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "type": enum (AdType),
  "id": string,
  "displayUrl": string,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (SearchAds360TextAdInfo)
  },
  "expandedTextAd": {
    object (SearchAds360ExpandedTextAdInfo)
  },
  "responsiveSearchAd": {
    object (SearchAds360ResponsiveSearchAdInfo)
  },
  "productAd": {
    object (SearchAds360ProductAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (SearchAds360ExpandedDynamicSearchAdInfo)
  }
  // End of list of possible types for union field ad_data.
}

string

광고의 리소스 이름입니다. 광고 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/ads/{adId}

string

광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.

enum (AdType)

광고의 유형입니다.

string (int64 format)

광고의 ID입니다.

string

일부 광고 형식의 광고 설명에 표시되는 URL입니다.

string

광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다.

object (SearchAds360TextAdInfo)

텍스트 광고와 관련된 세부정보입니다.

object (SearchAds360ExpandedTextAdInfo)

확장 텍스트 광고와 관련된 세부정보입니다.

object (SearchAds360ResponsiveSearchAdInfo)

반응형 검색 광고와 관련된 세부정보입니다.

object (SearchAds360ProductAdInfo)

제품 광고와 관련된 세부정보입니다.

object (SearchAds360ExpandedDynamicSearchAdInfo)

확장 동적 검색 광고와 관련된 세부정보입니다.

{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}

string

광고의 제목입니다.

string

광고 설명의 첫 번째 줄입니다.

string

광고 설명의 두 번째 줄입니다.

string

광고의 표시 URL입니다.

string

광고의 표시된 모바일 URL입니다.

string (int64 format)

광고의 추적 ID입니다.

{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

string

광고의 제목입니다.

string

광고의 두 번째 제목입니다.

string

광고의 세 번째 제목입니다.

string

광고 설명의 첫 번째 줄입니다.

string

광고 설명의 두 번째 줄입니다.

string

구분자와 함께 자동 생성된 표시 URL에 추가되는 텍스트입니다.

string

구분자와 함께 path1에 추가된 텍스트입니다.

string (int64 format)

광고의 추적 ID입니다.

{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 광고 제목이 선택됩니다.

object (AdTextAsset)

설명용 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.

string

구분자와 함께 자동 생성된 표시 URL에 추가되는 텍스트입니다.

string

구분자와 함께 path1에 추가된 텍스트입니다.

string (int64 format)

광고의 추적 ID입니다.

{
  "text": string
}

string

애셋 텍스트

{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}

string

광고 설명의 첫 번째 줄입니다.

string

광고 설명의 두 번째 줄입니다.

string (int64 format)

광고의 추적 ID입니다.

{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}

string

광고그룹 광고 라벨의 리소스 이름입니다. 광고그룹 광고 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}입니다.

string

라벨이 첨부된 광고그룹 광고입니다.

string

광고그룹 광고에 지정된 라벨입니다.

{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}

string

광고 그룹 애셋의 리소스 이름입니다. AdGroupAsset 리소스 이름의 형식은 다음과 같습니다.

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

string

필수 항목입니다. 애셋이 연결된 광고 그룹입니다.

string

필수 항목입니다. 광고 그룹에 연결된 애셋입니다.

enum (AssetLinkStatus)

광고그룹 애셋의 상태입니다.

{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}

string

광고 그룹 애셋 세트의 리소스 이름입니다. 광고그룹 애셋 세트 리소스 이름의 형식은 다음과 같습니다.

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

string

이 애셋 세트가 연결된 광고그룹입니다.

string

광고 그룹에 연결된 애셋 세트입니다.

enum (AssetSetLinkStatus)

광고그룹 애셋 세트의 상태입니다. 읽기 전용입니다.

{
  "resourceName": string
}

string

광고 그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

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

{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}

string

광고그룹 입찰가 조정의 리소스 이름입니다. 광고그룹 입찰가 조정 리소스 이름의 형식은 다음과 같습니다.

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

number

기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다.

object (DeviceInfo)

기기 기준입니다.

{
  "type": enum (Device)
}

enum (Device)

기기 유형입니다.

{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}

string

광고그룹 기준의 리소스 이름입니다. 광고그룹 기준 리소스 이름의 형식은 다음과 같습니다.

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

string

이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

enum (AdGroupCriterionStatus)

기준의 상태입니다.

고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다.

object (QualityInfo)

기준의 품질에 관한 정보입니다.

enum (CriterionType)

기준의 유형입니다.

string

이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다.

object (PositionEstimates)

다양한 게재순위에서의 기준 입찰가 견적입니다.

string

광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.

string

외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Google Ads 이외의 계정(예: Yahoo Japan, Microsoft, Baidu 등)에만 사용됩니다. 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)

CPC(클릭당비용) 입찰가입니다.

string (int64 format)

유효 CPC(클릭당비용) 입찰가입니다.

enum (AdGroupCriterionEngineStatus)

광고 그룹 기준의 엔진 상태입니다.

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.

string

추적 URL을 만들기 위한 URL 템플릿입니다.

object (KeywordInfo)

키워드.

object (ListingGroupInfo)

등록정보 그룹

object (AgeRangeInfo)

연령대입니다.

object (GenderInfo)

성별입니다.

object (UserListInfo)

사용자 목록.

object (WebpageInfo)

웹페이지

object (LocationInfo)

위치를 탭합니다.

{
  "qualityScore": integer
}

integer

품질평가점수입니다.

Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다.

{
  "topOfPageCpcMicros": string
}

string (int64 format)

검색결과 첫 페이지의 상단에 광고가 게재되는 데 필요할 것으로 예상되는 CPC 입찰가입니다.

{
  "matchType": enum (KeywordMatchType),
  "text": string
}

enum (KeywordMatchType)

키워드의 일치 유형입니다.

string

키워드의 텍스트입니다(최대 80자 및 10개 단어).

{
  "type": enum (ListingGroupType)
}

enum (ListingGroupType)

목록 그룹의 유형입니다.

{
  "type": enum (AgeRangeType)
}

enum (AgeRangeType)

연령대의 유형입니다.

{
  "type": enum (GenderType)
}

enum (GenderType)

성별 유형입니다.

{
  "userList": string
}

string

사용자 목록 리소스 이름입니다.

{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}

object (WebpageConditionInfo)

웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

number

웹사이트 기준 노출 범위 비율입니다. 광고 그룹 및 캠페인에서 웹사이트 대상, 제외 웹사이트 대상, 제외 키워드를 기반으로 계산된 웹사이트 노출 범위 비율입니다. 예를 들어 노출 범위가 1로 반환되었으면 노출 범위가 100%입니다. 이 필드는 읽기 전용입니다.

string

이 매개변수로 정의된 기준의 이름입니다. name 값은 이 유형의 매개변수로 기준을 식별, 정렬 및 필터링하는 데 사용됩니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}

enum (WebpageConditionOperand)

웹페이지 타겟팅 조건의 피연산자입니다.

enum (WebpageConditionOperator)

웹페이지 타겟팅 조건의 연산자입니다.

string

웹페이지 타겟팅 조건의 인수입니다.

{
  "geoTargetConstant": string
}

string

지역 대상 상수 리소스 이름입니다.

{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}

string

광고그룹 기준 라벨의 리소스 이름입니다. 광고그룹 기준 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}입니다.

string

라벨이 연결된 광고그룹 기준입니다.

string

광고그룹 기준에 할당된 라벨입니다.

{
  "resourceName": string,
  "adGroup": string,
  "label": string
}

string

광고 그룹 라벨의 리소스 이름입니다. 광고그룹 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}입니다.

string

라벨이 연결된 광고그룹입니다.

string

광고그룹에 지정된 라벨입니다.

{
  "resourceName": string
}

string

연령대 뷰의 리소스 이름입니다. 연령대 뷰 리소스 이름의 형식은 다음과 같습니다.

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

{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}

string

애셋의 리소스 이름입니다. 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assets/{assetId}

enum (AssetType)

저작물의 유형입니다.

string

모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.

enum (AssetStatus)

애셋의 상태입니다.

string

이 애셋이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

string

이 애셋이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

string (int64 format)

저작물의 ID입니다.

string

애셋의 이름입니다(선택사항).

string

추적 URL을 만들기 위한 URL 템플릿입니다.

enum (AssetEngineStatus)

저작물의 엔진 상태입니다.

object (YoutubeVideoAsset)

YouTube 동영상 애셋

object (ImageAsset)

이미지 확장 소재입니다.

object (TextAsset)

텍스트 애셋입니다.

object (UnifiedCalloutAsset)

통합 콜아웃 확장 소재

object (UnifiedSitelinkAsset)

통합 사이트링크 확장 소재입니다.

object (UnifiedPageFeedAsset)

통합 페이지 피드 애셋입니다.

object (MobileAppAsset)

모바일 앱 확장 소재

object (UnifiedCallAsset)

통합 전화번호 확장 소재

object (CallToActionAsset)

클릭 유도 문구 애셋입니다.

object (UnifiedLocationAsset)

통합 위치 확장 소재입니다.

{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}

string

YouTube 동영상 제목입니다.

string

YouTube 동영상 ID입니다. YouTube 동영상 URL에 사용되는 11자리 문자열 값입니다.

{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}

enum (MimeType)

이미지 애셋의 MIME 유형입니다.

object (ImageDimension)

원본 크기로 이 이미지에 대한 메타데이터입니다.

string (int64 format)

이미지 애셋의 파일 크기(바이트)입니다.

{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}

string (int64 format)

이미지의 높이입니다.

string (int64 format)

이미지의 너비입니다.

string

이 높이와 너비의 이미지를 반환하는 URL입니다.

{
  "text": string
}

string

텍스트 애셋의 텍스트 콘텐츠입니다.

{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}

string

콜아웃 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

string

이 확장 소재가 적용되고 게재를 시작할 수 있는 yyyy-MM-dd 형식의 시작일입니다.

string

이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다.

object (AdScheduleInfo)

저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개의 일정(총 42개)을 만들 수 있습니다.

boolean

검색 사용자의 시간대로 애셋을 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}

enum (MinuteOfHour)

일정이 시작되는 시작 시간(분) 후의 시간입니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

enum (MinuteOfHour)

일정이 종료되는 종료 시간 이후의 시간(분)입니다. 일정은 종료 시간(분)을 제외합니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

enum (DayOfWeek)

일정이 적용되는 요일입니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

integer

24시간 형식으로 표시한 시작 시간입니다. 이 필드는 0 이상, 23 이하여야 합니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

integer

24시간 형식으로 표시한 종료 시간입니다. 24 는 하루의 끝을 의미합니다. 이 필드는 0 이상, 24 이하여야 합니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}

string

사이트링크의 URL 표시 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

string

사이트링크 설명의 첫 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description2도 설정해야 합니다.

string

사이트링크 설명의 두 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description1도 설정해야 합니다.

string

이 확장 소재가 적용되고 게재를 시작할 수 있는 yyyy-MM-dd 형식의 시작일입니다.

string

이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다.

object (AdScheduleInfo)

저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개의 일정(총 42개)을 만들 수 있습니다.

string (int64 format)

사이트링크 확장 소재의 클릭수를 추적하는 데 사용되는 ID입니다. Yahoo! Japan만 해당 필드에 입력하세요.

boolean

검색 사용자의 시간대로 사이트링크 확장 소재를 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

boolean

휴대기기에 사이트링크 확장 소재를 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

{
  "pageUrl": string,
  "labels": [
    string
  ]
}

string

광고주가 타겟팅하려는 웹페이지입니다.

string

페이지 URL을 그룹화하는 데 사용되는 라벨입니다.

{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}

string

필수 항목입니다. 모바일 애플리케이션을 고유하게 식별하는 문자열입니다. 플랫폼 네이티브 ID(예: 'com.android.ebay')만 포함해야 합니다. Android의 경우 또는 '12345689' 입니다.

enum (MobileAppVendor)

필수 항목입니다. 이 특정 앱을 배포하는 앱 스토어입니다.

{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}

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 형식)입니다.

{
  "callToAction": enum (CallToActionType)
}

enum (CallToActionType)

클릭 유도 문구.

{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}

string

장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 이 필드는 특정 고객 ID 및 애셋 유형에 따라 고유합니다. 장소 ID에 대한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

object (BusinessProfileLocation)

고객의 업체 위치 목록입니다. 위치 확장 소재가 비즈니스 프로필 계정에서 동기화되는 경우에만 반환됩니다. 동일한 계정에서 동일한 장소 ID를 가리키는 여러 비즈니스 프로필 비즈니스 정보를 보유할 수 있습니다.

enum (LocationOwnershipType)

위치 소유권의 유형입니다. 유형이 BUSINESS_OWNER인 경우 위치 광고 확장으로 게재됩니다. 유형이 'AFFILIATE'인 경우 제휴사 위치로 게재됩니다.

{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}

string

광고주가 비즈니스 프로필 계정의 위치에 라벨을 지정했습니다. 이 정보는 비즈니스 프로필 계정에서 동기화됩니다.

string

이 위치의 비즈니스 프로필 판매점 코드입니다. 이 정보는 비즈니스 프로필 계정에서 동기화됩니다.

string (int64 format)

이 비즈니스 프로필 위치의 비즈니스 정보 ID입니다. 연결된 비즈니스 프로필 계정에서 동기화됩니다.

{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}

string

애셋 그룹 애셋의 리소스 이름입니다. 애셋 그룹 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

string

이 애셋 그룹 애셋이 연결하는 애셋 그룹입니다.

string

애셋 그룹 애셋이 연결되는 애셋입니다.

enum (AssetFieldType)

애셋 그룹 내 애셋의 게재위치에 대한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO 등

enum (AssetLinkStatus)

애셋과 애셋 그룹 간 연결의 상태입니다.

{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}

string

애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

string

애셋 그룹 신호가 속한 애셋 그룹입니다.

object (AudienceInfo)

실적 최대화 캠페인에서 사용할 잠재고객 신호입니다.

{
  "audience": string
}

string

잠재고객 리소스 이름입니다.

{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}

string

애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다. 애셋 그룹 등록정보 그룹 필터 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

string

이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다.

string (int64 format)

ListingGroupFilter의 ID입니다.

enum (ListingGroupFilterType)

등록정보 그룹 필터 노드의 유형입니다.

enum (ListingGroupFilterVertical)

현재 노드 트리가 나타내는 세로입니다. 같은 트리에 있는 모든 노드는 같은 카테고리에 속해야 합니다.

object (ListingGroupFilterDimension)

이 등록정보 그룹이 상위 항목을 조정하는 데 사용하는 측정기준 값입니다. 루트 그룹에 정의되지 않았습니다.

string

상위 등록정보 그룹 하위 그룹의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다.

object (ListingGroupFilterDimensionPath)

이 등록정보 그룹 필터를 정의하는 측정기준의 경로입니다.

{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}

object (ProductBiddingCategory)

제품의 입찰 카테고리입니다.

object (ProductBrand)

제품의 브랜드입니다.

object (ProductChannel)

제품 제공 지역.

object (ProductCondition)

제품의 상태입니다.

object (ProductCustomAttribute)

제품의 맞춤 속성입니다.

object (ProductItemId)

제품의 상품 ID입니다.

object (ProductType)

제품 제공 유형입니다.

{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}

enum (ListingGroupFilterBiddingCategoryLevel)

분류에 있는 카테고리의 수준을 나타냅니다.

string (int64 format)

제품 입찰 카테고리의 ID입니다.

이 ID는 다음 도움말에 설명된 google_product_category ID와 동일합니다. https://support.google.com/merchants/answer/6324436

{
  "value": string
}

string

제품 브랜드의 문자열 값입니다.

{
  "channel": enum (ListingGroupFilterProductChannel)
}

enum (ListingGroupFilterProductChannel)

지역의 값입니다.