पोस्ट: सूची

यह पोस्ट की सूची वापस लाता है. इसे अभी आज़माएं या उदाहरण देखें.

अगर पोस्ट किसी ऐसे ब्लॉग पर हैं जिसे निजी के तौर पर सेट किया गया है, तो अनुमति लेना ज़रूरी है. अगर पोस्ट किसी ऐसे ब्लॉग पर हैं जिसे सार्वजनिक तौर पर देखा जा सकता है, तो इस तरीके को बिना अनुमति के कॉल किया जा सकता है.

अनुरोध

एचटीटीपी अनुरोध

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 नतीजों पर लागू किया गया क्रम.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "published": पोस्ट पब्लिश होने की तारीख के हिसाब से क्रम लगाएं
  • "updated": पोस्ट को पिछली बार अपडेट किए जाने की तारीख के हिसाब से क्रम में लगाएं
sortOption string UNAVAILABLE NOW

नतीजों पर क्रम से लगाने का तरीका लागू किया गया.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "descending": पोस्ट को समय के हिसाब से घटते क्रम में लगाएं (डिफ़ॉल्ट)
  • "ascending": पोस्ट को समय के हिसाब से बढ़ते क्रम में लगाएं
pageToken string अगर अनुरोध को पेज में बांटा गया है, तो जारी रखने का टोकन.
startDate datetime फ़ेच करने के लिए, पोस्ट करने की सबसे पुरानी तारीख. यह date-time है और इसे RFC 3339 फ़ॉर्मैट में लिखा जाता है.
status string

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "draft": ड्राफ़्ट पोस्ट
  • "live": पब्लिश की गई पोस्ट
  • "scheduled": वे पोस्ट जिन्हें आने वाले समय में पब्लिश करने के लिए शेड्यूल किया गया है.
view string

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "ADMIN": एडमिन लेवल की जानकारी
  • "AUTHOR": लेखक के लेवल की जानकारी
  • "READER": Reader level detail

अनुरोध का मुख्य भाग

इस तरीके के साथ अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो यह जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर दिखाता है:

{
  "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();

}

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, यहां दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.