REST Resource: accounts.locations.localPosts

리소스: LocalPost

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

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

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
필드
name

string

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

string

현지 게시물의 언어입니다.
summary

string

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

object (CallToAction)

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

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
scheduledTime

string (Timestamp format)

설정된 경우 게시물이 게시되는 시기를 결정합니다. 사용자가 미리 게시물을 예약하도록 설정할 수 있습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
recurringInstanceTime
(deprecated)

string (Timestamp format)

출력 전용입니다. 지원 중단됨: 대신 event.recurring_instance_time을 사용하세요. 이 필드는 향후 버전에서 삭제될 예정입니다. 출력 전용입니다. 게시물의 가장 최근 반복 인스턴스가 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
event

object (LocalPostEvent)

이벤트 정보입니다. EVENT 및 OFFER 주제 유형에 필수입니다.
state

enum (LocalPostState)

출력 전용입니다. 게시물의 상태로, 수명 주기의 어느 부분에 있는지 나타냅니다.
media[]

object (MediaItem)

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

string

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

enum (LocalPostTopicType)

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

enum (AlertType)

게시물이 작성된 알림 유형입니다. 이 필드는 topicType이 Alert인 게시물에만 적용되며 알림의 하위 유형으로 작동합니다.
통합 필드 topic_type_specific_fields. 주제 유형을 위한 특정 필드입니다. topic_type_specific_fields은 다음 중 하나여야 합니다.
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)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
필드
title

string

이벤트 이름입니다.
schedule

object (TimeInterval)

이벤트 시작 및 종료 날짜/시간입니다.
recurrenceInfo

object (RecurrenceInfo)

선택사항입니다. 반복 게시물의 빈도에 관한 정보를 저장합니다. 게시물이 반복 게시물인 경우에만 설정됩니다.
recurringInstanceTime

string (Timestamp format)

출력 전용입니다. 게시물의 가장 최근 반복 인스턴스가 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

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)

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

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date 및 google.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 이하여야 합니다.

RecurrenceInfo

지역 게시물의 반복 정보를 나타냅니다.

JSON 표현 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
필드
seriesEndTime

string (Timestamp format)

선택사항입니다. 반복 시리즈의 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
통합 필드 occurrence_pattern. 반복 게시물의 발생 패턴입니다. occurrence_pattern은 다음 중 하나여야 합니다.
dailyPattern

object (DailyOccurrencePattern)

일일 발생 패턴입니다.
weeklyPattern

object (WeeklyOccurrencePattern)

주간 발생 패턴입니다.
monthlyPattern

object (MonthlyOccurrencePattern)

월별 발생 패턴입니다.

DailyOccurrencePattern

이 유형에는 필드가 없습니다.

일일 발생 패턴을 나타냅니다.

WeeklyOccurrencePattern

주간 반복 패턴을 나타냅니다.

JSON 표현 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
필드
daysOfWeek[]

enum (DayOfWeek)

선택사항입니다. 혜택/이벤트의 요일 목록입니다. 비어 있으면 게시물이 이벤트의 schedule.start_time과 동일한 요일에 반복됩니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

MonthlyOccurrencePattern

월별 반복 패턴을 나타냅니다.

JSON 표현 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
필드
통합 필드 monthly_option. 월간 발생 패턴의 반복 옵션입니다. monthly_option은 다음 중 하나여야 합니다.
dayOfMonth

integer

월의 일입니다.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

해당 월의 요일 발생입니다. 요일은 이벤트 시작 시간의 요일로 추론됩니다. 예를 들어 이벤트가 금요일에 시작되고 dayOfWeekOccurrence가 SECOND인 경우 이벤트는 매월 두 번째 금요일에 반복됩니다.

DayOfWeekOccurrence

해당 월의 요일 발생입니다.

열거형
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED 지정되지 않은 요일 발생입니다.
FIRST 해당 월의 첫 번째 요일입니다.
SECOND 해당 월의 두 번째 요일입니다.
THIRD 한 달 중 세 번째 요일입니다.
FOURTH 한 달 중 네 번째 요일입니다.
LAST 해당 월의 마지막 요일입니다.

LocalPostState

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

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

LocalPostTopicType

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

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

AlertType

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

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

LocalPostOffer

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

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

string

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

string

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

string

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

메서드

create

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

delete

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

get

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

list

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

patch

 지정된 오프라인 게시물을 업데이트하고 업데이트된 오프라인 게시물을 반환합니다.