PostUserInfos: รายการ

ต้องมีการให้สิทธิ์

ดึงข้อมูลรายการคู่โพสต์และข้อมูลผู้ใช้ของโพสต์ ซึ่งอาจมีการกรอง ข้อมูลผู้ใช้ของโพสต์มีข้อมูลเกี่ยวกับโพสต์สำหรับผู้ใช้แต่ละราย เช่น สิทธิ์เข้าถึงสำหรับผู้ใช้รายนั้นๆ โดยเฉพาะ ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/blogger/v3/users/userId/blogs/blogId/posts

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์ที่จำเป็น
blogId string รหัสของบล็อกที่จะดึงข้อมูลโพสต์
userId string รหัสของผู้ใช้ที่จะดึงข้อมูลต่อผู้ใช้ คําว่า "ตนเอง" (ไม่ใส่เครื่องหมายคำพูด) หรือตัวระบุโปรไฟล์ของผู้ใช้
พารามิเตอร์ที่ไม่บังคับ
endDate datetime วันที่โพสต์ล่าสุดที่จะดึงข้อมูล ซึ่งเป็นวันที่และเวลาที่มีการจัดรูปแบบ RFC 3339
fetchBodies boolean ระบุว่าจะรวมเนื้อหาของโพสต์หรือไม่ ค่าเริ่มต้นคือ false (ค่าเริ่มต้น: false)
labels string รายการป้ายกํากับที่จะค้นหา โดยคั่นแต่ละรายการด้วยคอมมา
maxResults unsigned integer จำนวนสูงสุดของโพสต์ที่จะดึงข้อมูล
orderBy string ลำดับการจัดเรียงที่ใช้กับผลการค้นหา ค่าเริ่มต้นคือ published

ค่าที่ยอมรับมีดังนี้
  • "published": จัดเรียงตามวันที่เผยแพร่โพสต์
  • "updated": จัดเรียงตามวันที่อัปเดตโพสต์ล่าสุด
pageToken string โทเค็นการต่ออายุ ซึ่งใช้เพื่อเลื่อนดูชุดผลลัพธ์ขนาดใหญ่ หากต้องการดูหน้าถัดไปของผลการค้นหา ให้ตั้งค่าพารามิเตอร์นี้เป็นค่า "nextPageToken" จากการตอบกลับก่อนหน้า
startDate datetime วันที่โพสต์ที่เก่าที่สุดที่จะดึงข้อมูล ซึ่งเป็นวันที่และเวลาที่มีการจัดรูปแบบ RFC 3339
status string

ค่าที่ยอมรับมีดังนี้
  • "draft": โพสต์ฉบับร่าง
  • "live": โพสต์ที่เผยแพร่
  • "scheduled": โพสต์ที่กำหนดเวลาเผยแพร่ในอนาคต
view string

ค่าที่ยอมรับมีดังนี้
  • "ADMIN": รายละเอียดระดับผู้ดูแลระบบ
  • "AUTHOR": รายละเอียดระดับผู้แต่ง
  • "READER": รายละเอียดระดับผู้อ่าน

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ (อ่านเพิ่มเติมเกี่ยวกับการรับรองและการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

เนื้อหาของคำขอ

อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้

คำตอบ

หากทำสำเร็จ วิธีการนี้จะแสดงผลลัพธ์เป็นเนื้อหาการตอบกลับซึ่งมีโครงสร้างดังต่อไปนี้

{
  "kind": "blogger#postUserInfosList",
  "nextPageToken": string,
  "items": [
    postUserInfos Resource
  ]
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
kind string ประเภทของเอนทิตีนี้ blogger#postList เสมอ
nextPageToken string โทเค็นการแบ่งหน้าเพื่อเรียกข้อมูลหน้าถัดไป หากมี
items[] list รายการโพสต์ที่มีข้อมูลผู้ใช้สำหรับโพสต์นั้นๆ ในบล็อกนี้

ลองใช้งาน

ใช้โปรแกรมสำรวจ API ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลจริงและดูการตอบกลับ