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

لاسترداد قائمة بالمشاركات. جرِّب الآن أو شاهد مثالاً.

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

طلب

طلب 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

استخدام مكتبة عميل جافا

// 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();
}

جرِّب هذه الميزة الآن.

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