REST Resource: accounts.locations.localPosts

Tài nguyên: LocalPost

Đại diện cho bài đăng địa phương của một vị trí.

Biểu diễn dưới dạng 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)
  }
}
Các trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng của Google cho bài đăng địa phương này ở dạng: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

Ngôn ngữ của bài đăng địa phương.
summary

string

Nội dung mô tả/nội dung của bài đăng tại địa phương.
callToAction

object (CallToAction)

URL mà người dùng được chuyển tới khi nhấp vào quảng cáo. Bỏ qua đối với loại chủ đề OFFER.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo bài đăng.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian sửa đổi bài đăng gần đây nhất do người dùng thực hiện.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
event

object (LocalPostEvent)

Thông tin về sự kiện. Bắt buộc đối với loại chủ đề EVENT và OFFER.
state

enum (LocalPostState)

Chỉ có đầu ra. Trạng thái của bài đăng, cho biết bài đăng đang ở phần nào trong vòng đời của bài đăng.
media[]

object (MediaItem)

Nội dung nghe nhìn liên kết với bài đăng. sourceUrl là trường dữ liệu duy nhất được hỗ trợ cho LocalPost MediaItem.
searchUrl

string

Chỉ có đầu ra. Đường liên kết đến bài đăng tại địa phương trong Google Tìm kiếm. Bạn có thể dùng đường liên kết này để chia sẻ bài đăng qua mạng xã hội, email, văn bản, v.v.
topicType

enum (LocalPostTopicType)

Bắt buộc. Loại chủ đề của bài đăng: tiêu chuẩn, sự kiện, ưu đãi hoặc thông báo.
alertType

enum (AlertType)

Loại thông báo mà bài đăng được tạo. Trường này chỉ áp dụng cho các bài đăng thuộc loại Cảnh báo topicType và hoạt động như một loại Cảnh báo phụ.
offer

object (LocalPostOffer)

Dữ liệu bổ sung cho các bài đăng về ưu đãi. Bạn chỉ nên đặt thuộc tính này khi topicType là OFFER.

CallToAction

Hành động được thực hiện khi người dùng nhấp vào bài đăng

Biểu diễn dưới dạng JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Các trường
actionType

enum (ActionType)

Loại hành động sẽ được thực hiện.
url

string

URL mà người dùng sẽ được chuyển hướng đến khi nhấp vào. Bạn không nên đặt trường này cho lời kêu gọi hành động trong cuộc gọi.

ActionType

Loại hành động sẽ được thực hiện.

Enum
ACTION_TYPE_UNSPECIFIED Chưa xác định loại.
BOOK Bài đăng này muốn người dùng đặt lịch hẹn/bảng/v.v.
ORDER Bài đăng này muốn người dùng đặt món.
SHOP Bài đăng này muốn người dùng duyệt xem danh sách sản phẩm.
LEARN_MORE Bài đăng này muốn người dùng tìm hiểu thêm (tại trang web của họ).
SIGN_UP Bài đăng này muốn người dùng đăng ký/đăng ký/tham gia nội dung nào đó.
GET_OFFER

Không dùng nữa. Sử dụng OFFER trong LocalPostTopicType để tạo bài đăng có nội dung ưu đãi.
CALL Bài đăng này muốn người dùng gọi điện cho doanh nghiệp này.

LocalPostEvent

Tất cả thông tin liên quan đến một sự kiện xuất hiện trong bài đăng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
Các trường
title

string

Tên của sự kiện.
schedule

object (TimeInterval)

Ngày/giờ bắt đầu và kết thúc sự kiện.

TimeInterval

Một khoảng thời gian, bao gồm cả hai giá trị này. Mã này phải chứa tất cả các trường để hợp lệ.

Biểu diễn dưới dạng JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Các trường
startDate

object (Date)

Ngày bắt đầu của giai đoạn này.
startTime

object (TimeOfDay)

Thời điểm bắt đầu giai đoạn này.
endDate

object (Date)

Ngày kết thúc của giai đoạn này.
endTime

object (TimeOfDay)

Thời gian kết thúc của giai đoạn này.

TimeOfDay

Đại diện cho thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. API có thể chọn cho phép giây nhuận. Các loại có liên quan là google.type.Date và google.protobuf.Timestamp.

Biểu diễn dưới dạng JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Các trường
hours

integer

Giờ trong ngày ở định dạng 24 giờ. Nên ở trong khoảng từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" trong các trường hợp như thời gian đóng cửa của doanh nghiệp.
minutes

integer

Số phút trong giờ trong ngày. Phải từ 0 đến 59.
seconds

integer

Số giây trong phút. Thông thường phải từ 0 đến 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

integer

Phân số giây tính bằng nano giây. Phải từ 0 đến 999.999.999.

LocalPostState

Cho biết bài đăng đang ở trạng thái nào

Enum
LOCAL_POST_STATE_UNSPECIFIED Chưa chỉ định tiểu bang.
REJECTED Bài đăng này đã bị từ chối do vi phạm chính sách nội dung.
LIVE Bài đăng này đã được xuất bản và hiện đang xuất hiện trong kết quả tìm kiếm.
PROCESSING Bài đăng này đang được xử lý và không xuất hiện trong kết quả tìm kiếm.

LocalPostTopicType

Loại chủ đề của bài đăng địa phương, được dùng để chọn các mẫu khác nhau nhằm tạo và hiển thị bài đăng.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Chưa chỉ định loại bài đăng nào.
STANDARD Bài đăng chứa thông tin cơ bản, chẳng hạn như nội dung tóm tắt và hình ảnh.
EVENT Bài đăng chứa thông tin cơ bản và sự kiện.
OFFER Bài đăng chứa thông tin cơ bản, nội dung liên quan đến sự kiện và ưu đãi (ví dụ: mã giảm giá)
ALERT Thông báo kịp thời và có mức độ ưu tiên cao liên quan đến một sự kiện đang diễn ra. Không phải lúc nào bạn cũng có thể viết các loại bài đăng này.

AlertType

Loại sự kiện mà bài đăng thông báo được tạo.

Enum
ALERT_TYPE_UNSPECIFIED Chưa chỉ định cảnh báo nào.
COVID_19 Cảnh báo về đại dịch bệnh vi-rút corona năm 2019. Bài đăng về Covid chỉ hỗ trợ một trường tóm tắt và trường lời kêu gọi hành động. Khi các cảnh báo này không còn phù hợp, tính năng tạo bài đăng cảnh báo mới cho loại COVID-19 sẽ bị vô hiệu hoá. Tuy nhiên, người bán vẫn có thể quản lý các bài đăng hiện có liên quan đến COVID-19.

LocalPostOffer

Các trường cụ thể cho bài đăng về ưu đãi.

Biểu diễn dưới dạng JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Các trường
couponCode

string

Không bắt buộc. Mã ưu đãi có thể sử dụng được trên cửa hàng hoặc trên mạng.
redeemOnlineUrl

string

Không bắt buộc. Đường liên kết trực tuyến để sử dụng ưu đãi.
termsConditions

string

Không bắt buộc. Các điều khoản và điều kiện của ưu đãi.

Phương thức

create

 Tạo một bài đăng mới tại địa phương được liên kết với vị trí đã chỉ định rồi trả về vị trí đó.

delete

 Xoá bài đăng địa phương.

get

 Lấy bài đăng địa phương được chỉ định.

list

 Trả về danh sách các bài đăng địa phương được liên kết với một vị trí.

patch

 Cập nhật bài đăng địa phương được chỉ định và trả về bài đăng địa phương đã cập nhật.

reportInsights

 Trả về thông tin chi tiết cho một nhóm các bài đăng địa phương được liên kết với một trang thông tin.