وبلاگ ها: 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	لیست سطح مدیریت وبلاگ اطلاعات هر کاربر

مثال ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه کلاینت جاوا استفاده می کند

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

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.