AssetSet

저작물 모음을 나타내는 저작물 세트입니다. AssetSetAsset을 사용하여 애셋을 애셋 세트에 연결합니다.

JSON 표현
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
필드
id

string (int64 format)

출력 전용. 애셋 세트의 ID입니다.

resourceName

string

변경할 수 없습니다. 애셋 세트의 리소스 이름입니다. 애셋 세트 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetSets/{asset_set_id}

name

string

필수 항목입니다. 애셋 세트의 이름입니다. 필수 항목입니다. 길이는 1~128자여야 합니다.

type

enum (AssetSetType)

필수 항목입니다. 변경할 수 없습니다. 애셋 세트의 유형입니다. 필수 항목입니다.

status

enum (AssetSetStatus)

출력 전용. 애셋 세트의 상태입니다. 읽기 전용입니다.

merchantCenterFeed

object (MerchantCenterFeed)

Google 판매자 센터의 판매자 ID 및 피드 라벨

locationGroupParentAssetSetId

string (int64 format)

변경할 수 없습니다. 이 애셋 세트의 요소를 가져오는 애셋 세트의 상위 애셋 세트 ID입니다. 예를 들어 LocationGroup AssetSet의 요소가 가져온 동기화 수준 location AssetSet ID가 여기에 해당합니다. 이 필드는 필수이며 위치 그룹 유형 AssetSet에만 적용됩니다.

hotelPropertyData

object (HotelPropertyData)

출력 전용. Hotel Center 계정 링크가 있는 여행 목표 달성을 위한 실적 최대화 캠페인 읽기 전용입니다.

통합 필드 asset_set_source. 각 애셋 세트 유형에 적용되는 애셋 세트 데이터 모든 유형에 특정 데이터가 있는 것은 아닙니다. asset_set_source은 다음 중 하나여야 합니다.
locationSet

object (LocationSet)

위치 확장 소재 세트 데이터 동기화 수준 위치 설정에 사용됩니다. AssetSet 유형이 LOCATION_SYNC인 경우에만 설정할 수 있습니다.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

비즈니스 프로필 위치 그룹 애셋 세트 데이터

chainLocationGroup

object (ChainLocationGroup)

체인 동적 위치 그룹에 대한 정보를 나타냅니다. 동기화 수준 AssetSet의 유형이 LOCATION_SYNC이고 동기화 소스가 체인인 경우에만 적용됩니다.

AssetSetStatus

확장 소재 세트의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다.
ENABLED 애셋 세트가 사용 설정되었습니다.
REMOVED 애셋 세트가 삭제됩니다.

MerchantCenterFeed

Google 판매자 센터의 판매자 ID 및 피드 라벨

JSON 표현
{
  "merchantId": string,
  "feedLabel": string
}
필드
merchantId

string (int64 format)

필수 항목입니다. Google 판매자 센터의 판매자 ID

feedLabel

string

선택사항입니다. Google 판매자 센터의 피드 라벨

HotelPropertyData

Hotel Center 계정 링크가 있는 여행 목표 달성을 위한 실적 최대화 캠페인 읽기 전용입니다.

JSON 표현
{
  "hotelCenterId": string,
  "partnerName": string
}
필드
hotelCenterId

string (int64 format)

출력 전용. 파트너의 Hotel Center ID입니다.

partnerName

string

출력 전용. 호텔 파트너의 이름입니다.

LocationSet

위치 세트와 관련된 데이터입니다. Google 비즈니스 프로필 (이전 명칭: Google 마이 비즈니스) 데이터, 체인 데이터, 지도 위치 데이터 중 하나를 지정해야 합니다.

JSON 표현
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
필드
locationOwnershipType

enum (LocationOwnershipType)

필수 항목입니다. 변경할 수 없습니다. 위치 소유권 유형 (소유 위치 또는 제휴사 위치)입니다.

통합 필드 source. 각 동기화 소스와 관련된 위치 데이터 source은 다음 중 하나여야 합니다.
businessProfileLocationSet

object (BusinessProfileLocationSet)

Google 비즈니스 프로필 위치에서 채워진 위치 세트를 구성하는 데 사용되는 데이터입니다.

chainLocationSet

object (ChainSet)

지정된 체인으로 채워진 체인 세트의 위치를 구성하는 데 사용되는 데이터입니다.

mapsLocationSet

object (MapsLocationSet)

선택한 지도 위치를 기반으로 위치가 동기화된 경우에만 설정

BusinessProfileLocationSet

Google 비즈니스 프로필 위치에서 채워진 위치 세트를 구성하는 데 사용되는 데이터입니다. 서로 다른 유형의 필터는 지정되면 AND로 연결됩니다.

JSON 표현
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
필드
httpAuthorizationToken

string

필수 항목입니다. 변경할 수 없습니다. 승인을 가져오는 데 사용되는 HTTP 인증 토큰입니다.

emailAddress

string

필수 항목입니다. 변경할 수 없습니다. Google 비즈니스 프로필 계정의 이메일 주소 또는 Google 비즈니스 프로필 계정 관리자의 이메일 주소

businessNameFilter

string

업체 이름별로 Google 비즈니스 프로필 등록정보를 필터링하는 데 사용됩니다. businessNameFilter가 설정된 경우 일치하는 업체 이름이 있는 비즈니스 정보만 애셋에 동기화될 수 있습니다.

labelFilters[]

string

라벨별로 Google 비즈니스 프로필 등록정보를 필터링하는 데 사용됩니다. labelFilter에 항목이 존재하는 경우 설정된 라벨 중 하나가 있는 등록정보만 애셋에 동기화될 수 있습니다. labelFilter에 항목이 없는 경우 모든 비즈니스 정보가 동기화 후보가 됩니다. 라벨 필터는 OR로 연결됩니다.

listingIdFilters[]

string (int64 format)

비즈니스 정보 ID별로 Google 비즈니스 프로필 등록정보를 필터링하는 데 사용됩니다. ListingIdFilters에 항목이 있으면 필터로 지정된 등록정보만 애셋에 동기화될 수 있습니다. ListingIdFilters에 항목이 없으면 모든 비즈니스 정보가 동기화 대상입니다. 등록정보 ID 필터는 OR로 연결됩니다.

businessAccountId

string

변경할 수 없습니다. 위치를 사용할 관리 비즈니스의 계정 ID입니다. 이 필드를 설정하지 않으면 사용자가 액세스할 수 있는 (emailAddress로 지정) 모든 비즈니스가 사용됩니다.

ChainSet

지정된 체인으로 채워진 위치 세트를 구성하는 데 사용되는 데이터입니다.

JSON 표현
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
필드
relationshipType

enum (ChainRelationshipType)

필수 항목입니다. 변경할 수 없습니다. 지정된 체인과 이 광고주의 관계 유형입니다.

chains[]

object (ChainFilter)

필수 항목입니다. 체인 수준 필터의 목록이며, 모든 필터는 OR로 연결됩니다.

ChainRelationshipType

가능한 관계 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AUTO_DEALERS 자동차 대리점 관계
GENERAL_RETAILERS 일반적인 소매업체 관계

ChainFilter

피드 항목 집합의 위치에 적용되는 체인 수준 1개 필터입니다. 모든 필드 간의 필터링 논리는 AND입니다.

JSON 표현
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
필드
chainId

string (int64 format)

필수 항목입니다. 체인 ID로 체인 위치를 필터링하는 데 사용됩니다. 지정된 체인에 속한 체인 위치만 애셋 세트에 포함됩니다.

locationAttributes[]

string

위치 속성별로 체인 위치를 필터링하는 데 사용됩니다. 지정된 모든 속성에 속한 체인 위치만 애셋 세트에 포함됩니다. 이 필드가 비어 있으면 이 필드에서 필터링이 없다는 의미입니다.

MapsLocationSet

여러 지도 위치 동기화 데이터의 래퍼

JSON 표현
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
필드
mapsLocations[]

object (MapsLocationInfo)

필수 항목입니다. 사용자가 수동으로 동기화한 지도 위치 정보의 목록입니다.

MapsLocationInfo

장소 ID용 래퍼

JSON 표현
{
  "placeId": string
}
필드
placeId

string

지도 위치의 장소 ID입니다.

BusinessProfileLocationGroup

비즈니스 프로필 동적 위치 그룹에 관한 정보입니다. 동기화 수준 AssetSet의 유형이 LOCATION_SYNC이고 동기화 소스가 비즈니스 프로필인 경우에만 적용됩니다.

JSON 표현
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
필드
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

동적 비즈니스 프로필 위치 설정에 대해 필터링합니다.

DynamicBusinessProfileLocationGroupFilter

애셋 집합에서 비즈니스 프로필 위치에 대한 필터를 나타냅니다. 여러 필터가 제공되면 AND로 연결됩니다.

JSON 표현
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
필드
labelFilters[]

string

라벨별로 비즈니스 프로필 위치를 필터링하는 데 사용됩니다. 나열된 라벨 중 하나라도 해당하는 위치만 애셋 세트에 포함됩니다. 라벨 필터는 OR로 연결됩니다.

listingIdFilters[]

string (int64 format)

비즈니스 정보 ID를 기준으로 비즈니스 프로필 위치를 필터링하는 데 사용됩니다.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

비즈니스 이름별로 비즈니스 프로필 위치를 필터링하는 데 사용됩니다.

BusinessProfileBusinessNameFilter

비즈니스 프로필 위치 그룹 비즈니스 이름 필터입니다.

JSON 표현
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
필드
businessName

string

필터링에 사용할 업체 이름 문자열입니다.

filterType

enum (LocationStringFilterType)

businessName으로 필터링할 때 사용할 문자열 일치 유형입니다.

LocationStringFilterType

위치 문자열 필터의 가능한 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXACT 필터는 정확한 문자열 일치를 사용합니다.

ChainLocationGroup

체인 동적 위치 그룹에 대한 정보를 나타냅니다. 동기화 수준 AssetSet의 유형이 LOCATION_SYNC이고 동기화 소스가 체인인 경우에만 적용됩니다.

JSON 표현
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
필드
dynamicChainLocationGroupFilters[]

object (ChainFilter)

체인 ID로 체인 위치를 필터링하는 데 사용됩니다. 지정된 체인에 속한 위치만 애셋 세트에 포함됩니다.