المشاركات: قائمة

لاسترداد قائمة بالمشاركات. جرِّب الخدمة الآن أو اطّلِع على مثال.

يجب الحصول على تفويض إذا كانت المشاركات على مدونة خاصة. إذا كانت المشاركات على مدونة عامة، فيمكن استدعاء هذه الطريقة بدون إذن.

الطلب

طلب 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 يتم تطبيق ترتيب الترتيب على النتائج.

في ما يلي القيم المقبولة:
  • "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": تفاصيل مستوى القارئ

نص الطلب

لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.

الإجابة

في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
اسم الموقع القيمة الوصف Notes
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();
}

تجربة

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.