- 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 ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Giá trị nhận dạng của Google cho bài đăng địa phương này ở dạng: |
languageCode |
Ngôn ngữ của bài đăng địa phương. |
summary |
Nội dung mô tả/nội dung của bài đăng tại địa phương. |
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ủ đề |
createTime |
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ụ: |
updateTime |
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ụ: |
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 đang ở 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 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 |
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 |
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 |
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 ( |
Các 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 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 |
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 ( |
Các trường | |
---|---|
title |
Tên của 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 để hợp lệ.
Biểu diễn dưới dạng JSON | |
---|---|
{ "startDate": { object ( |
Các trường | |
---|---|
startDate |
Ngày bắt đầu của giai đoạn này. |
startTime |
Thời điểm bắt đầu giai đoạn này. |
endDate |
Ngày kết thúc của giai đoạn này. |
endTime |
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 |
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 |
Số phút trong giờ trong ngày. Phải từ 0 đến 59. |
seconds |
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 |
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 |
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 |
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. Cá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 mới tại địa phương được liên kết với vị trí đã chỉ định rồi trả về vị trí đó. |
|
Xoá bài đăng địa phương. |
|
Lấy bài đăng địa phương đượ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 được liên kết với một trang thông tin. |