Сообщения: список

Получает список сообщений. Попробуйте прямо сейчас или посмотрите пример .

Авторизация требуется, если сообщения находятся в блоге, который является частным. Если сообщения находятся в публичном блоге, то этот метод можно вызывать без авторизации.

Запрос

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

Попробуй!

Используйте обозреватель API ниже, чтобы вызвать этот метод для оперативных данных и просмотреть ответ.