Feed

피드

JSON 표현 
{
  "resourceName": string,
  "attributes": [
    {
      object (FeedAttribute)
    }
  ],
  "attributeOperations": [
    {
      object (FeedAttributeOperation)
    }
  ],
  "origin": enum (FeedOrigin),
  "status": enum (FeedStatus),
  "id": string,
  "name": string,

  // Union field system_feed_generation_data can be only one of the following:
  "placesLocationFeedData": {
    object (PlacesLocationFeedData)
  },
  "affiliateLocationFeedData": {
    object (AffiliateLocationFeedData)
  }
  // End of list of possible types for union field system_feed_generation_data.
}
필드
resourceName

string

변경할 수 없습니다. 피드의 리소스 이름입니다. 피드 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/feeds/{feedId}
attributes[]

object (FeedAttribute)

피드의 속성 CREATE에 필수이지만 system_feed_generation_data를 제공하지 않으면 Google Ads에서 올바른 속성으로 피드를 업데이트합니다. UPDATE에서는 허용되지 않습니다. attributeOperations를 사용하여 새 속성을 추가하세요.
attributeOperations[]

object (FeedAttributeOperation)

피드 속성을 변경하는 작업의 목록입니다. 속성은 추가만 할 수 있고 삭제할 수는 없습니다.
origin

enum (FeedOrigin)

변경할 수 없습니다. 피드의 FeedAttributes를 관리할 사용자를 지정합니다.
status

enum (FeedStatus)

출력 전용. 피드의 상태입니다. 이 필드는 읽기 전용입니다.
id

string (int64 format)

출력 전용. 피드의 ID입니다. 이 필드는 읽기 전용입니다.
name

string

변경할 수 없습니다. 피드 이름입니다. 필수 항목입니다.
통합 필드 system_feed_generation_data. 피드의 시스템 데이터입니다. 이 데이터는 시스템 생성 피드의 피드 항목을 생성하기 위한 정보를 지정합니다. system_feed_generation_data은 다음 중 하나여야 합니다.
placesLocationFeedData

object (PlacesLocationFeedData)

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

object (AffiliateLocationFeedData)

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

FeedAttribute

FeedAttributes는 피드에 있어야 하는 데이터의 유형을 정의합니다. 단일 FeedAttribute는 동일한 FeedAttributeId를 가진 FeedItemAttributes의 예상 유형을 지정합니다. 선택사항으로, FeedAttribute를 FeedItem 고유 키의 일부로 표시할 수 있습니다.

JSON 표현 
{
  "type": enum (FeedAttributeType),
  "id": string,
  "name": string,
  "isPartOfKey": boolean
}
필드
type

enum (FeedAttributeType)

피드 속성의 데이터 유형입니다. 필수 항목입니다.
id

string (int64 format)

속성의 ID입니다.
name

string

속성의 이름입니다. 필수 항목입니다.
isPartOfKey

boolean

이 속성에 해당하는 데이터가 FeedItem의 고유 키의 일부임을 나타냅니다. 지정하지 않으면 기본값은 false입니다. 피드의 스키마에는 고유 키가 필요하지 않습니다. 이 경우 FeedItems는 feed_item_id로 참조되어야 합니다.

FeedAttributeType

피드 속성에 사용할 수 있는 데이터 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
INT64 Int64.
DOUBLE Double.
STRING 문자열.
BOOLEAN 부울.
URL URL입니다.
DATE_TIME 날짜/시간
INT64_LIST Int64 목록.
DOUBLE_LIST 더블 (8바이트) 목록입니다.
STRING_LIST 문자열 목록입니다.
BOOLEAN_LIST 불리언 목록입니다.
URL_LIST URL 목록입니다.
DATE_TIME_LIST 날짜/시간 목록입니다.
PRICE 가격.

FeedAttributeOperation

변형의 피드 속성 목록에 대해 수행할 작업입니다.

JSON 표현 
{
  "operator": enum (Operator),
  "value": {
    object (FeedAttribute)
  }
}
필드
operator

enum (Operator)

출력 전용. 수행할 목록 작업의 유형입니다.
value

object (FeedAttribute)

출력 전용. 목록에 추가되는 피드 속성입니다.

운영자

연산자입니다.

열거형
UNSPECIFIED 지정되지 않았습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ADD 기존 속성에 속성을 추가합니다.

FeedOrigin

피드 출처에 사용할 수 있는 값입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
USER 이 피드의 FeedAttributes는 사용자가 관리합니다. 사용자는 이 피드에 FeedAttributes를 추가할 수 있습니다.
GOOGLE GOOGLE 피드의 FeedAttributes는 Google에서 만듭니다. 이 유형의 피드는 Google에서 유지 관리하며 피드의 자리표시자 유형에 맞는 속성을 갖습니다.

FeedStatus

가능한 피드 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 피드가 사용 설정되었습니다.
REMOVED 피드가 삭제되었습니다.

PlacesLocationFeedData

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

JSON 표현 
{
  "oauthInfo": {
    object (OAuthInfo)
  },
  "businessAccountId": string,
  "categoryFilters": [
    string
  ],
  "labelFilters": [
    string
  ],
  "emailAddress": string,
  "businessNameFilter": string
}
필드
oauthInfo

object (OAuthInfo)

변경할 수 없습니다. 이메일에 필요한 인증 토큰 (OAuth API)입니다. 이 필드는 생성 요청에서만 지정할 수 있습니다. 모든 하위 필드는 선택할 수 없습니다.
businessAccountId

string

위치를 사용해야 하는 관리 비즈니스의 플러스 페이지 ID입니다. 이 필드를 설정하지 않으면 사용자가 액세스할 수 있는 (emailAddress로 지정) 모든 비즈니스가 사용됩니다. 이 필드는 변경 전용이며 선택할 수 없습니다.
categoryFilters[]

string

비즈니스 프로필 등록정보를 카테고리별로 필터링하는 데 사용됩니다. categoryFilters에 항목이 있으면 어떤 카테고리에 속하는 등록정보만 FeedItems에 동기화될 수 있습니다. categoryFilters에 항목이 없으면 모든 비즈니스 정보가 동기화 후보가 됩니다.
labelFilters[]

string

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

string

비즈니스 프로필의 이메일 주소 또는 비즈니스 프로필 관리자의 이메일 주소 필수 항목입니다.
businessNameFilter

string

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

OAuthInfo

OAuth를 사용한 승인에 사용되는 데이터입니다.

JSON 표현 
{
  "httpMethod": string,
  "httpRequestUrl": string,
  "httpAuthorizationHeader": string
}
필드
httpMethod

string

승인을 가져오는 데 사용되는 HTTP 메서드입니다.
httpRequestUrl

string

승인을 가져오는 데 사용되는 HTTP 요청 URL입니다.
httpAuthorizationHeader

string

승인을 가져오는 데 사용되는 HTTP 인증 헤더입니다.

AffiliateLocationFeedData

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

JSON 표현 
{
  "chainIds": [
    string
  ],
  "relationshipType": enum (AffiliateLocationFeedRelationshipType)
}
필드
chainIds[]

string (int64 format)

제휴사 위치 피드가 위치를 동기화하는 체인의 목록입니다.
relationshipType

enum (AffiliateLocationFeedRelationshipType)

체인과 광고주의 관계입니다.

AffiliateLocationFeedRelationshipType

제휴사 위치 피드의 관계 유형에 사용할 수 있는 값입니다.

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