المدونات: listByUser

يتطلب تفويضًا

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

طلب

طلب HTTP

GET https://www.googleapis.com/blogger/v3/users/userId/blogs

المَعلمات

اسم المعلَمة القيمة الوصف
المعلّمات المطلوبة
userId string رقم تعريف المستخدم الذي سيتم جلب مدوناته. إما كلمة self أو رقم تعريف الملف الشخصي للمستخدم.
المعلّمات الاختيارية
fetchUserInfo boolean ما إذا كان الرد عبارة عن قائمة بالمدونات التي تحتوي على معلومات لكل مستخدم بدلاً من المدونات فقط.
view string

القيم المقبولة هي:
  • "ADMIN": تفاصيل على مستوى المشرف
  • "AUTHOR": تفاصيل على مستوى المؤلف
  • "READER": تفاصيل على مستوى المشرف

التفويض

ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

نص الطلب

لا توفر نص طلب بهذه الطريقة.

الإجابة

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

{
  "kind": "blogger#blogList",
  "items": [
    blogs Resource
  ],
  "blogUserInfos": [
    blogUserInfos Resource
  ]
}
اسم الموقع القيمة الوصف ملاحظات
kind string نوع هذا الكيان. blogger#blogList دائمًا.
items[] list قائمة المدونات التي يمتلك هذا المستخدم حقوق التأليف أو المشرف لها.
blogUserInfos[] list قائمة على مستوى المشرف لمعلومات المدونة لكل مستخدم

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

لغة Java

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

// 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-BlogListByUser-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action object.
ListByUser blogListByUserAction = blogger.blogs().listByUser("self");
// Restrict the result content to just the data we need.
blogListByUserAction.setFields("items(description,name,posts/totalItems,updated)");
// This step sends the request to the server.
BlogList blogList = blogListByUserAction.execute();
// Now we can navigate the response.
if (blogList.getItems() != null && !blogList.getItems().isEmpty()) {
int blogCount = 0;
for (Blog blog : blogList.getItems()) {
System.out.println("Blog #" + ++blogCount);
System.out.println("\tName: " + blog.getName());
System.out.println("\tDescription: " + blog.getDescription());
System.out.println("\tPost Count: " + blog.getPosts().getTotalItems());
System.out.println("\tLast Updated: " + blog.getUpdated());
}
}

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

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