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

تعرض هذه الطريقة قائمة بالمشاركات. جرِّبها الآن أو اطّلِع على مثال.

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

طلب

طلب HTTP

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 تحديد ما إذا كانت البيانات الوصفية لعنوان 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
  ]
}
اسم السمة القيمة الوصف ملاحظات
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();

}

جرِّبها الآن.

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