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)
  }
}
Trường
name

string

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

languageCode

string

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

summary

string

Phần 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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""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ủ đề EVENTOFFER.

state

enum (LocalPostState)

Chỉ có đầu ra. Trạng thái của bài đăng, cho biết bài đăng đó nằm trong 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 đị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: tiêu chuẩn, 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 của topicType Alert và hoạt động như một loại Cảnh báo phụ.

offer

object (LocalPostOffer)

Dữ liệu bổ sung cho bài đăng về ư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 qua 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 đế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 gọi điện.

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àn, 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 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 (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 hoạt động 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.

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ả hai giá trị này. Mã này phải chứa tất cả các trường thì mới 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 khoảng thời gian 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

Đạ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.Dategoogle.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 ở định dạng 24 giờ. Nên ở từ 0 đến 23. Một 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 ngày. Phải từ 0 đến 59.

seconds

integer

Số giây của thời gian. Giá trị thường phải từ 0 đến 59. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây.

nanos

integer

Các phân số của giây tính bằng nano giây. Giá trị phải nằm trong khoảng 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 Trạng thái không được chỉ định.
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 cục bộ, 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 xác định loại bài đăng.
STANDARD Bài đăng chứa thông tin cơ bản, chẳng hạn như bản 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, sự kiện và nội dung liên quan đến ư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 sự kiện đang diễn ra. Không phải lúc nào bạn cũng có thể viết 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 Chưa chỉ định cảnh báo nào.
COVID_19 Cảnh báo liên quan đến đại dịch vi-rút corona năm 2019. Bài đăng trên Covid 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 Thông 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 về ư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ực tuyến.

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 được liên kết với vị trí đã chỉ định và trả lại bài đăng đó.

delete

Xóa một bài đăng địa phương.

get

Lấy bài đăng cục bộ đượ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 liên kết với một trang thông tin.