- Tài nguyên: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- Phương thức
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 ( |
Trường | |
---|---|
name |
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: |
languageCode |
Ngôn ngữ của bài đăng địa phương. |
summary |
Phần mô tả/nội dung của bài đăng địa phương. |
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ủ đề |
createTime |
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ụ: |
updateTime |
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ụ: |
event |
Thông tin về sự kiện. Bắt buộc đối với loại chủ đề |
state |
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[] |
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 |
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 |
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 |
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 |
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 ( |
Trường | |
---|---|
actionType |
Loại hành động sẽ được thực hiện. |
url |
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 |
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 ( |
Trường | |
---|---|
title |
Tên sự kiện. |
schedule |
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 ( |
Trường | |
---|---|
startDate |
Ngày bắt đầu của khoảng thời gian này. |
startTime |
Thời gian bắt đầu của khoảng thời gian này. |
endDate |
Ngày kết thúc của khoảng thời gian này. |
endTime |
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.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 |
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 |
Số phút trong ngày. Phải từ 0 đến 59. |
seconds |
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 |
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 |
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 |
Không bắt buộc. Đường liên kết trực tuyến để sử dụng ưu đãi. |
termsConditions |
Không bắt buộc. Điều khoản và điều kiện của ưu đãi. |
Phương thức |
|
---|---|
|
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 đó. |
|
Xóa một bài đăng địa phương. |
|
Lấy bài đăng cục bộ được chỉ định. |
|
Trả về danh sách các bài đăng địa phương được liên kết với một vị trí. |
|
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. |
|
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. |