لاسترداد قائمة بالمشاركات. جرِّب الخدمة الآن أو اطّلِع على مثال.
يجب الحصول على تفويض إذا كانت المشاركات على مدونة خاصة. إذا كانت المشاركات على مدونة عامة، فيمكن استدعاء هذه الطريقة بدون إذن.
الطلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
المعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
المَعلمات المطلوبة | ||
blogId |
string |
رقم تعريف المدونة المطلوب جلب المشاركات منها. |
المَعلمات الاختيارية | ||
endDate |
datetime |
آخر تاريخ نشر يمكن استرجاعه، ويجب أن يكون date-time بالتنسيق RFC 3339.
|
fetchBodies |
boolean |
ما إذا كان يتم تضمين محتوى النص الأساسي للمشاركات (القيمة التلقائية: true) ويجب ضبط هذه السمة على "خطأ" عندما لا تكون نصوص النشر مطلوبة، وذلك للحدّ من حركة المرور.
(القيمة التلقائية: 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
لاستخدام مكتبة برامج 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();
}
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.