REST Resource: accounts.locations.localPosts

แหล่งข้อมูล: LocalPost

แสดงโพสต์ในพื้นที่สำหรับสถานที่หนึ่งๆ

การแสดง 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)
  }
}
ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ Google สำหรับโพสต์ในพื้นที่นี้ในรูปแบบ accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}
languageCode

string

ภาษาของโพสต์ในร้าน
summary

string

คำอธิบาย/เนื้อหาของโพสต์ในพื้นที่
callToAction

object (CallToAction)

URL ที่ระบบจะส่งผู้ใช้ไปเมื่อคลิกผ่านโปรโมชัน ละเว้นสำหรับหัวข้อประเภท OFFER
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างโพสต์

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาล่าสุดที่ผู้ใช้แก้ไขโพสต์

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
event

object (LocalPostEvent)

ข้อมูลกิจกรรม ต้องระบุสำหรับหัวข้อประเภท EVENT และ OFFER
state

enum (LocalPostState)

เอาต์พุตเท่านั้น สถานะของโพสต์ซึ่งบ่งบอกว่าโพสต์อยู่ในส่วนใดของวงจร
media[]

object (MediaItem)

สื่อที่เชื่อมโยงกับโพสต์ โดย sourceUrl เป็นช่องข้อมูลเดียวที่รองรับสำหรับ MediaItem ของ LocalPost
searchUrl

string

เอาต์พุตเท่านั้น ลิงก์ไปยังโพสต์ในพื้นที่ในการค้นหาของ Google คุณสามารถใช้ลิงก์นี้เพื่อแชร์โพสต์ผ่านโซเชียลมีเดีย อีเมล ข้อความ ฯลฯ
topicType

enum (LocalPostTopicType)

ต้องระบุ ประเภทหัวข้อของโพสต์ ได้แก่ มาตรฐาน กิจกรรม ข้อเสนอ หรือการแจ้งเตือน
alertType

enum (AlertType)

ประเภทการแจ้งเตือนที่สร้างโพสต์ ฟิลด์นี้ใช้ได้กับโพสต์ประเภทการแจ้งเตือนเท่านั้น และมีลักษณะเป็นการแจ้งเตือนย่อย
offer

object (LocalPostOffer)

ข้อมูลเพิ่มเติมสำหรับโพสต์ข้อเสนอ ควรตั้งค่าเฉพาะในกรณีที่ topicType เป็น OFFER

CallToAction

การดําเนินการที่ดำเนินการเมื่อผู้ใช้คลิกผ่านโพสต์

การแสดง JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
ช่อง
actionType

enum (ActionType)

ประเภทการดำเนินการที่จะทำ
url

string

URL ที่ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าเว็บนั้นเมื่อผู้ใช้คลิก ไม่ควรตั้งค่าช่องนี้สำหรับคำกระตุ้นให้ดำเนินการ (Call-To-Action) ประเภทโทร

ActionType

ประเภทการดำเนินการที่จะทำ

Enum
ACTION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท
BOOK โพสต์นี้ต้องการให้ผู้ใช้จองการนัดหมาย/โต๊ะ/ฯลฯ
ORDER โพสต์นี้ต้องการให้ผู้ใช้สั่งซื้อสินค้า
SHOP โพสต์นี้ต้องการให้ผู้ใช้เรียกดูแคตตาล็อกผลิตภัณฑ์
LEARN_MORE โพสต์นี้ต้องการให้ผู้ใช้ดูข้อมูลเพิ่มเติม (ที่เว็บไซต์)
SIGN_UP โพสต์นี้ต้องการให้ผู้ใช้ลงทะเบียน/ลงชื่อสมัครใช้/เข้าร่วมกิจกรรม
GET_OFFER

เลิกใช้งานแล้ว ใช้ OFFER ใน LocalPostTopicType เพื่อสร้างโพสต์ที่มีเนื้อหาข้อเสนอ
CALL โพสต์นี้ต้องการให้ผู้ใช้โทรหาธุรกิจ

LocalPostEvent

ข้อมูลทั้งหมดที่เกี่ยวข้องกับกิจกรรมที่แสดงในโพสต์ในพื้นที่

การแสดง JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
ช่อง
title

string

ชื่อเหตุการณ์
schedule

object (TimeInterval)

วันที่/เวลาเริ่มต้นและสิ้นสุดของกิจกรรม

TimeInterval

ช่วงเวลา (รวมวันที่เริ่มต้น) โดยต้องมีทุกช่องจึงจะถูกต้อง

การแสดง JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
ช่อง
startDate

object (Date)

วันที่เริ่มต้นของระยะเวลานี้
startTime

object (TimeOfDay)

เวลาเริ่มต้นของระยะเวลานี้
endDate

object (Date)

วันที่สิ้นสุดของระยะเวลานี้
endTime

object (TimeOfDay)

เวลาสิ้นสุดของระยะเวลานี้

TimeOfDay

แสดงช่วงเวลาของวัน วันที่และเขตเวลาไม่สำคัญหรือระบุไว้ที่อื่น API อาจเลือกที่จะอนุญาตวินาทีของ leap ประเภทที่เกี่ยวข้องคือ google.type.Date และ google.protobuf.Timestamp

การแสดง JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ช่อง
hours

integer

เวลาของวันในรูปแบบ 24 ชั่วโมง ควรมีค่าระหว่าง 0 ถึง 23 API อาจเลือกที่จะอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes

integer

นาทีของชั่วโมงของวัน ต้องมีค่าระหว่าง 0 ถึง 59
seconds

integer

วินาทีของนาที โดยปกติต้องมีค่าระหว่าง 0 ถึง 59 API อาจอนุญาตให้ใช้ค่า 60 ได้หากอนุญาตให้ใช้วินาทีของ leap
nanos

integer

เศษส่วนของวินาทีเป็นนาโนวินาที ต้องมีค่าระหว่าง 0 ถึง 999,999,999

LocalPostState

ระบุสถานะของโพสต์

Enum
LOCAL_POST_STATE_UNSPECIFIED ไม่ได้ระบุสถานะ
REJECTED โพสต์นี้ถูกปฏิเสธเนื่องจากละเมิดนโยบายเนื้อหา
LIVE โพสต์นี้เผยแพร่แล้วและกำลังปรากฏในผลการค้นหา
PROCESSING กำลังประมวลผลโพสต์นี้และจะไม่ปรากฏในผลการค้นหา

LocalPostTopicType

ประเภทหัวข้อของโพสต์ในร้าน ซึ่งใช้เลือกเทมเพลตต่างๆ เพื่อสร้างและแสดงผลโพสต์

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทโพสต์
STANDARD โพสต์มีข้อมูลพื้นฐาน เช่น ข้อมูลสรุปและรูปภาพ
EVENT โพสต์มีข้อมูลพื้นฐานและกิจกรรม
OFFER โพสต์มีข้อมูลพื้นฐาน เนื้อหาเกี่ยวกับกิจกรรมและข้อเสนอ (เช่น รหัสคูปอง)
ALERT ประกาศที่มีลำดับความสำคัญสูงและทันท่วงทีเกี่ยวกับกิจกรรมที่กำลังดำเนินอยู่ โพสต์ประเภทเหล่านี้อาจไม่พร้อมใช้งานสำหรับการเขียนเสมอไป

AlertType

ประเภทเหตุการณ์ที่สร้างโพสต์การแจ้งเตือน

Enum
ALERT_TYPE_UNSPECIFIED ไม่ได้ระบุการแจ้งเตือน
COVID_19 การแจ้งเตือนที่เกี่ยวข้องกับการระบาดของโรคไวรัสโคโรนา 2019 โพสต์เกี่ยวกับโควิดรองรับเฉพาะฟิลด์ข้อมูลสรุปและฟิลด์คำกระตุ้นให้ดำเนินการ เมื่อการแจ้งเตือนเหล่านี้ไม่เกี่ยวข้องอีกต่อไป ระบบจะปิดใช้การสร้างโพสต์การแจ้งเตือนใหม่สำหรับประเภทโควิด-19 อย่างไรก็ตาม ผู้ขายจะยังคงจัดการโพสต์เกี่ยวกับโควิด-19 ที่มีอยู่ได้

LocalPostOffer

ช่องเฉพาะสำหรับโพสต์ข้อเสนอ

การแสดง JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
ช่อง
couponCode

string

ไม่บังคับ รหัสข้อเสนอที่ใช้ได้ที่ร้านหรือทางออนไลน์
redeemOnlineUrl

string

ไม่บังคับ ลิงก์ออนไลน์เพื่อแลกรับข้อเสนอ
termsConditions

string

ไม่บังคับ ข้อกำหนดและเงื่อนไขของข้อเสนอ

เมธอด

create

 สร้างโพสต์ในพื้นที่ใหม่ซึ่งเชื่อมโยงกับสถานที่ที่ระบุ และแสดงผล

delete

 ลบโพสต์ในพื้นที่

get

 รับโพสต์ในพื้นที่ที่ระบุ

list

 แสดงรายการโพสต์ในพื้นที่ที่เชื่อมโยงกับสถานที่ตั้ง

patch

 อัปเดตโพสต์ในพื้นที่ที่ระบุและแสดงผลโพสต์ในพื้นที่ที่อัปเดต

reportInsights

 แสดงข้อมูลเชิงลึกสําหรับชุดโพสต์ในพื้นที่ที่เชื่อมโยงกับข้อมูลหนึ่งๆ