यह पोस्ट की सूची वापस लाता है. इसे अभी आज़माएं या उदाहरण देखें.
अगर पोस्ट किसी ऐसे ब्लॉग पर हैं जिसे निजी के तौर पर सेट किया गया है, तो अनुमति लेना ज़रूरी है. अगर पोस्ट किसी ऐसे ब्लॉग पर हैं जिसे सार्वजनिक तौर पर देखा जा सकता है, तो इस तरीके को बिना अनुमति के कॉल किया जा सकता है.
अनुरोध
एचटीटीपी अनुरोध
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
पैरामीटर
पैरामीटर का नाम | मान | ब्यौरा |
---|---|---|
ज़रूरी पैरामीटर | ||
blogId |
string |
उस ब्लॉग का आईडी जिससे पोस्ट फ़ेच करनी हैं. |
वैकल्पिक पैरामीटर | ||
endDate |
datetime |
फ़ेच करने के लिए, पोस्ट की सबसे नई तारीख. यह date-time है और इसे RFC 3339 फ़ॉर्मैट में लिखा जाता है.
|
fetchBodies |
boolean |
क्या पोस्ट का मुख्य कॉन्टेंट शामिल किया गया है (डिफ़ॉल्ट: true). अगर पोस्ट के मुख्य हिस्से की ज़रूरत नहीं है, तो इसे false पर सेट करें. इससे ट्रैफ़िक को कम करने में मदद मिलेगी.
(डिफ़ॉल्ट: true )
|
fetchImages |
boolean |
हर पोस्ट के लिए, इमेज के यूआरएल का मेटाडेटा शामिल किया गया है या नहीं. |
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
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();
}
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, यहां दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.