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 เป็นช่องข้อมูลเดียวที่รองรับสำหรับ LocalPost MediaItem
searchUrl

string

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

enum (LocalPostTopicType)

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

enum (AlertType)

ประเภทการแจ้งเตือนที่ใช้สร้างโพสต์ ช่องนี้ใช้ได้กับโพสต์ของ topicType Alert เท่านั้น และจะทำงานเป็นประเภทย่อยของการแจ้งเตือน
offer

object (LocalPostOffer)

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

CallToAction

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

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

enum (ActionType)

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

string

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

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 อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องคือ 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 หากอนุญาตวินาทีอธิกสุรทิน
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 โพสต์โควิดรองรับเฉพาะช่องสรุปและช่องคำกระตุ้นให้ดำเนินการ (Call-To-Action) เมื่อการแจ้งเตือนเหล่านี้ไม่เกี่ยวข้องอีกต่อไป ระบบจะปิดใช้การสร้างโพสต์การแจ้งเตือนใหม่สำหรับประเภทโควิด-19 อย่างไรก็ตาม ผู้ขายจะยังจัดการโพสต์เกี่ยวกับโควิด-19 ที่มีอยู่ได้

LocalPostOffer

ช่องข้อมูลที่เจาะจงสำหรับโพสต์ข้อเสนอ

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

string

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

string

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

string

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

วิธีการ

create

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

delete

 ลบโพสต์ในเครื่อง

get

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

list

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

patch

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

reportInsights

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