REST Resource: accounts.locations.localPosts

리소스: LocalPost

위치의 지역 게시물을 나타냅니다.

JSON 표현
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
필드
name

string

출력 전용입니다. 이 지역 게시물의 Google 식별자입니다. 형식: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}

languageCode

string

지역 게시물의 언어입니다.

summary

string

지역 게시물의 설명/본문입니다.

callToAction

object (CallToAction)

사용자가 프로모션을 클릭하면 연결되는 URL입니다. 주제 유형 OFFER에서 무시됩니다.

createTime

string (Timestamp format)

출력 전용입니다. 게시물 작성 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 사용자가 마지막으로 게시물을 수정한 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

event

object (LocalPostEvent)

일정 정보입니다. 주제 유형 EVENTOFFER에 필수입니다.

state

enum (LocalPostState)

출력 전용입니다. 게시물이 수명 주기 중 어느 부분에 있는지 나타내는 게시물의 상태입니다.

media[]

object (MediaItem)

게시물과 연결된 미디어입니다. sourceUrl은 LocalPost MediaItem에 지원되는 유일한 데이터 필드입니다.

searchUrl

string

출력 전용입니다. Google 검색에 표시되는 지역 게시물 링크입니다. 이 링크는 소셜 미디어, 이메일, 문자 메시지 등을 통해 게시물을 공유하는 데 사용할 수 있습니다.

topicType

enum (LocalPostTopicType)

필수 항목입니다. 게시물의 주제 유형(일반, 이벤트, 혜택, 알림)입니다.

alertType

enum (AlertType)

게시물이 작성된 알림의 유형입니다. 이 필드는 topicType 알림의 게시물에만 적용되며 알림의 하위 유형으로 작동합니다.

offer

object (LocalPostOffer)

쿠폰 게시물에 대한 추가 데이터입니다. topicType이 OFFER인 경우에만 설정해야 합니다.

CallToAction

사용자가 게시물을 클릭할 때 수행되는 동작입니다.

JSON 표현
{
  "actionType": enum (ActionType),
  "url": string
}
필드
actionType

enum (ActionType)

수행될 작업의 유형입니다.

url

string

클릭 시 사용자가 연결되는 URL입니다. 통화 CTA에서는 이 필드를 설정되지 않은 상태로 두어야 합니다.

ActionType

수행될 작업의 유형입니다.

열거형
ACTION_TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
BOOK 사용자가 약속/테이블 등을 예약하도록 유도하는 게시물입니다.
ORDER 사용자의 주문을 유도하는 게시물입니다.
SHOP 사용자가 제품 카탈로그를 둘러보도록 유도하는 게시물입니다.
LEARN_MORE 사용자가 웹사이트에서 자세한 내용을 확인하도록 유도하는 게시물입니다.
SIGN_UP 사용자의 등록/가입/참여를 유도하는 게시물입니다.
GET_OFFER

지원 중단되었습니다. LocalPostTopicType에서 OFFER을(를) 사용하여 혜택 콘텐츠가 포함된 게시물을 작성하세요.

CALL 사용자가 비즈니스에 전화를 걸도록 유도하는 게시물입니다.

LocalPostEvent

지역 게시물에 표시된 이벤트와 관련된 모든 정보입니다.

JSON 표현
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
필드
title

string

이벤트 이름입니다.

schedule

object (TimeInterval)

일정 시작 및 종료 날짜/시간

TimeInterval

시간 간격입니다(해당 값 포함). 모든 필드가 있어야 유효할 수 있습니다.

JSON 표현
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
필드
startDate

object (Date)

이 기간의 시작일입니다.

startTime

object (TimeOfDay)

이 기간의 시작 시간입니다.

endDate

object (Date)

이 기간의 종료일입니다.

endTime

object (TimeOfDay)

이 기간의 종료 시간입니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Dategoogle.protobuf.Timestamp입니다.

JSON 표현
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
필드
hours

integer

24시간 형식의 시간입니다. 0~23 사이의 값이어야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.

minutes

integer

특정 시간의 분입니다. 0~59 사이의 값이어야 합니다.

seconds

integer

특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.

nanos

integer

나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다.

LocalPostState

게시물의 상태를 나타냅니다.

열거형
LOCAL_POST_STATE_UNSPECIFIED 상태가 지정되지 않았습니다.
REJECTED 이 게시물은 콘텐츠 정책 위반으로 인해 거부되었습니다.
LIVE 이 게시물은 게시되었으며 현재 검색 결과에 표시되고 있습니다.
PROCESSING 이 게시물은 처리 중이며 검색결과에 표시되지 않습니다.

LocalPostTopicType

지역 게시물의 주제 유형으로, 게시물을 만들고 렌더링하는 다양한 템플릿을 선택하는 데 사용됩니다.

열거형
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED 지정된 게시물 유형이 없습니다.
STANDARD 게시물에 요약 및 이미지와 같은 기본 정보가 포함됩니다.
EVENT 게시물에 기본 정보와 이벤트가 포함됩니다.
OFFER 게시물에 기본 정보, 이벤트, 혜택 관련 콘텐츠 (예: 쿠폰 코드)가 포함됨
ALERT 진행 중인 이벤트와 관련된 우선순위가 높고 시기적절한 공지입니다. 이러한 유형의 게시물을 항상 작성할 수 있는 것은 아닙니다.

AlertType

알림 게시물이 생성된 이벤트의 유형입니다.

열거형
ALERT_TYPE_UNSPECIFIED 알림이 지정되지 않았습니다.
COVID_19 2019 코로나바이러스 유행성 전염병과 관련된 알림입니다. 코로나19 게시물은 요약 필드와 클릭 유도 문구 필드만 지원합니다. 이러한 알림이 더 이상 관련이 없으면 코로나19 유형의 새로운 알림 게시물 생성이 사용 중지됩니다. 하지만 판매자는 기존 코로나19 게시물을 계속 관리할 수 있습니다.

LocalPostOffer

쿠폰 게시물의 특정 필드입니다.

JSON 표현
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
필드
couponCode

string

선택사항입니다. 매장 또는 온라인에서 사용할 수 있는 쿠폰 코드입니다.

redeemOnlineUrl

string

선택사항입니다. 쿠폰을 사용할 수 있는 온라인 링크입니다.

termsConditions

string

선택사항입니다. 혜택 이용약관

메서드

create

지정된 위치에 연결된 새 지역 게시물을 만들어 반환합니다.

delete

지역 게시물을 삭제합니다.

get

지정된 지역 게시물을 가져옵니다.

list

위치와 연결된 지역 게시물 목록을 반환합니다.

patch

지정된 지역 게시물을 업데이트하고 업데이트된 지역 게시물을 반환합니다.

reportInsights

단일 비즈니스 정보와 연결된 지역 게시물 집합에 대한 통계를 반환합니다.