ดึงข้อมูลรายการโพสต์ ลองใช้เลยหรือดูตัวอย่าง
ต้องมีการให้สิทธิ์หากโพสต์อยู่ในบล็อกที่เป็นแบบส่วนตัว หากโพสต์อยู่ในบล็อกที่เป็นแบบสาธารณะ คุณจะเรียกใช้เมธอดนี้ได้โดยไม่ต้องมีการให้สิทธิ์
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
พารามิเตอร์
| ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
|---|---|---|
| พารามิเตอร์ที่จำเป็น | ||
blogId |
string |
รหัสของบล็อกที่จะดึงข้อมูลโพสต์ |
| พารามิเตอร์ที่ไม่บังคับ | ||
endDate |
datetime |
วันที่โพสต์ล่าสุดที่จะดึงข้อมูล ซึ่งเป็น date-time ที่มีการจัดรูปแบบ RFC 3339
|
fetchBodies |
boolean |
รวมเนื้อหาของโพสต์หรือไม่ (ค่าเริ่มต้น: จริง) ควรตั้งค่าเป็น "false" เมื่อไม่จำเป็นต้องมีเนื้อหาของโพสต์ เพื่อช่วยลดการเข้าชม
(ค่าเริ่มต้น: true)
|
fetchImages |
boolean |
รวมข้อมูลเมตาของ URL รูปภาพสำหรับแต่ละโพสต์หรือไม่ |
labels |
string |
รายการป้ายกำกับที่คั่นด้วยคอมมาที่จะค้นหา |
maxResults |
unsigned integer |
จำนวนโพสต์สูงสุดที่จะดึงข้อมูล |
orderBy |
string |
ลำดับการจัดเรียงที่ใช้กับผลลัพธ์
ค่าที่ยอมรับมีดังนี้
|
sortOption |
string |
UNAVAILABLE NOW
ลำดับการจัดเรียงที่ใช้กับผลลัพธ์ ค่าที่ยอมรับมีดังนี้
|
pageToken |
string |
โทเค็นการต่อเนื่องหากคำขอมีการแบ่งหน้า |
startDate |
datetime |
วันที่โพสต์ที่เร็วที่สุดที่จะดึงข้อมูล ซึ่งเป็น date-time ที่มีการจัดรูปแบบ RFC 3339
|
status |
string |
ค่าที่ยอมรับมีดังนี้
|
view |
string |
ค่าที่ยอมรับมีดังนี้
|
เนื้อความของคำขอ
อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้
การตอบกลับ
หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับที่มีโครงสร้างดังต่อไปนี้
{
"kind": "blogger#postList",
"nextPageToken": string,
"items": [
posts Resource
]
}| ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
|---|---|---|---|
kind |
string |
ประเภทของเอนทิตีนี้ เสมอ blogger#postList |
|
nextPageToken |
string |
โทเค็นการแบ่งหน้าเพื่อดึงข้อมูลหน้าถัดไป หากมี | |
items[] |
list |
รายการโพสต์สำหรับบล็อกนี้ |
ตัวอย่าง
หมายเหตุ: ตัวอย่างโค้ดที่มีสำหรับวิธีการนี้ไม่ได้แสดงถึงภาษาโปรแกรมที่รองรับทั้งหมด (ดูรายการภาษาที่รองรับได้ในหน้าไลบรารีของไคลเอ็นต์)
Java
// The BlogId for the Blogger Buzz blog String BUZZ_BLOG_ID = "2399953";
// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();
// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
JSON_FACTORY, new LocalServerReceiver(),
Arrays.asList(BloggerScopes.BLOGGER));
// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
.setApplicationName("Blogger-PostsList-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);
// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");
// This step sends the request to the server.
PostList posts = postsListAction.execute();
// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
for (Post post : posts.getItems()) {
System.out.println("Post #"+ ++postCount);
System.out.println("\tTitle: "+post.getTitle());
System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
System.out.println("\tPublished: "+post.getPublished());
System.out.println("\tURL: "+post.getUrl());
System.out.println("\tContent: "+post.getContent());
}
// Pagination logic
String pageToken = posts.getNextPageToken();
if (pageToken == null || ++pageCount >= 5) {
break;
}
System.out.println("-- Next page of posts");
postsListAction.setPageToken(pageToken);
posts = postsListAction.execute();
}
ลองใช้งาน
ใช้โปรแกรมสำรวจ API ด้านล่างเพื่อเรียกเมธอดนี้ในข้อมูลสดและดูการตอบกลับ