تعرض هذه الطريقة قائمة بالمشاركات. جرِّبها الآن أو اطّلِع على مثال.
يجب الحصول على إذن إذا كانت المشاركات على مدونة خاصة. إذا كانت المشاركات في مدونة متاحة للجميع، يمكن استدعاء هذه الطريقة بدون إذن.
طلب
طلب 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 |
ترتيب الفرز المطبَّق على النتائج.
القيم المقبولة هي:
|
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();
}
جرِّبها الآن.
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب البيانات من خلال هذه الطريقة والاطّلاع على الردّ.