REST Resource: accounts.locations.localPosts

Tài nguyên: LocalPost

Biểu thị một bài đăng tại địa phương cho 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)
  }
}
Trường
name

string

Chỉ có đầu ra. Mã 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 trên trang thông tin địa phương.
summary

string

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

object (CallToAction)

URL mà người dùng được chuyển đến khi nhấp vào chương trình khuyến mãi. Bỏ qua đối với loại chủ đề OFFER.
createTime

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 người dùng sửa đổi bài đăng gần đây nhất.

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

object (LocalPostEvent)

Thông tin sự kiện. Bắt buộc đối với các 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 ở giai đoạn nào trong vòng đời.
media[]

object (MediaItem)

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

string

Chỉ có đầu ra. Đường liên kết đến bài đăng đị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, tin nhắn, v.v.
topicType

enum (LocalPostTopicType)

Bắt buộc. Loại chủ đề của bài đăng: thông thường, sự kiện, ưu đãi hoặc cảnh 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 topicType Cảnh báo và hoạt động như một loại phụ của Cảnh báo.
offer

object (LocalPostOffer)

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

CallToAction

Một 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
}
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 về cuộc gọi.

ActionType

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

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

Không dùng nữa. Sử dụng OFFER trong LocalPostTopicType để tạo một 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.

LocalPostEvent

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

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

string

Tên 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ả giá trị đầu và giá trị cuối. Tệp 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)
  }
}
Trường
startDate

object (Date)

Ngày bắt đầu của kỳ này.
startTime

object (TimeOfDay)

Thời gian bắt đầu của khoảng thời gian này.
endDate

object (Date)

Ngày kết thúc của khoảng thời gian này.
endTime

object (TimeOfDay)

Thời gian kết thúc của khoảng thời gian này.

TimeOfDay

Biểu thị 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 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
}
Trường
hours

integer

Giờ trong ngày theo định dạng 24 giờ. Phải từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng 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 phải nằm trong khoảng 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 trạng thái của bài đăng

Enum
LOCAL_POST_STATE_UNSPECIFIED Chưa chỉ định trạng thái.
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, dùng để chọn các mẫu khác nhau để tạo và hiển thị bài đăng.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Chưa chỉ định loại bài đăng.
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à một sự kiện.
OFFER Bài đăng chứa thông tin cơ bản, một sự kiện và nội dung liên quan đến ưu đãi (ví dụ: mã phiếu giảm giá)
ALERT Thông báo có mức độ ưu tiên cao và kịp thời 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ể tạo những loại bài đăng này.

AlertType

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

Enum
ALERT_TYPE_UNSPECIFIED Không chỉ định cảnh báo nào.
COVID_19 Thông báo liên quan đến đại dịch bệnh do vi-rút corona 2019. Bài đăng về COVID-19 chỉ hỗ trợ trường tóm tắt và trường lời kêu gọi hành động. Khi những 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ó về COVID-19.

LocalPostOffer

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

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

string

Không bắt buộc. Mã ưu đãi có thể sử dụng tại 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. Đ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 địa phương mới liên kết với vị trí đã chỉ định rồi trả về bài đăng đó.

delete

 Xoá một bài đăng tại địa phương.

get

 Lấy bài đăng cục bộ được chỉ định.

list

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

patch

 Cập nhật bài đăng cục bộ đã chỉ định và trả về bài đăng cục bộ đã cập nhật.

reportInsights

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