Interfejs API Bloggera: korzystanie z interfejsu API

Interfejs API Bloggera umożliwia integrację treści z Bloggera z aplikacją za pomocą interfejsów API typu REST. Zanim zaczniesz, musisz skonfigurować autoryzację.

Wprowadzenie

Ten dokument jest przeznaczony dla programistów, którzy chcą tworzyć aplikacje mogące korzystać z interfejsu API Bloggera. Blogger to narzędzie do tworzenia witryn, które pozwalają użytkownikom dzielić się swoimi przemyśleniami na temat podstawowych zasad.

Jeśli nie znasz się na pojęciach z Bloggera, zapoznaj się z artykułem Pierwsze kroki.

Autoryzacja żądań i identyfikacja aplikacji

Każde żądanie wysyłane do aplikacji przez interfejsy API Bloggera musi identyfikować Twoją aplikację w Google. Istnieją 2 sposoby identyfikowania aplikacji: użycie tokenu OAuth 2.0 (który dodatkowo autoryzuje żądanie) i klucza interfejsu API aplikacji. Jak określić, których z tych opcji użyć:

• Jeśli żądanie wymaga autoryzacji (na przykład żądania prywatnych danych konkretnej osoby), aplikacja musi udostępnić token OAuth 2.0. Aplikacja może również udostępnić klucz interfejsu API, ale nie musi.
• Jeśli żądanie nie wymaga autoryzacji (na przykład żądania danych publicznych), aplikacja musi udostępnić klucz interfejsu API lub token OAuth 2.0 (bądź oba z tych rozwiązań) według własnego uznania.

Informacje o protokołach autoryzacji

Twoja aplikacja musi autoryzować żądania za pomocą protokołu OAuth 2.0. Inne protokoły nie są obsługiwane. Jeśli aplikacja używa funkcji Zaloguj się przez Google, niektórymi aspektami autoryzacji nie musisz się zajmować.

Autoryzowanie żądań za pomocą protokołu OAuth 2.0

Żądania do interfejsów API Bloggera dotyczące niepublicznych danych użytkowników muszą być autoryzowane przez uwierzytelnionego użytkownika.

Ten proces jest przeprowadzany przy użyciu identyfikatora klienta OAuth.

Uzyskiwanie identyfikatora klienta OAuth

Możesz też utworzyć je na stronie Dane logowania.

Szczegóły procesu autoryzacji z użyciem protokołu OAuth 2.0 różnią się nieznacznie w zależności od rodzaju projektowanej aplikacji. Do większości typów aplikacji ma zastosowanie ten ogólny proces:

1. Gdy Twoja aplikacja potrzebuje dostępu do danych użytkownika, prosi Google o konkretny zakres dostępu.
2. Google wyświetla użytkownikowi ekran zgody z prośbą o autoryzowanie dostępu aplikacji do niektórych danych.
3. Jeśli użytkownik wyrazi zgodę, Google przekazuje Twojej aplikacji ważny przez krótki czas token dostępu.
4. Aplikacja żąda danych użytkownika i dołącza do żądania token dostępu.
5. Jeśli Google uzna, że żądanie i token są prawidłowe, przesyła dane, o które prosisz.

Niektóre procesy obejmują dodatkowe kroki, takie jak wykorzystanie tokenów odświeżania do uzyskania nowych tokenów dostępu. Szczegółowe informacje o procesach obowiązujących w przypadku różnych typów aplikacji znajdziesz w dokumencie Google na temat protokołu OAuth 2.0.

Informacje o zakresie protokołu OAuth 2.0 na potrzeby interfejsów API Bloggera:

https://www.googleapis.com/auth/blogger

Aby poprosić o dostęp przy użyciu protokołu OAuth 2.0, aplikacja potrzebuje danych z zakresu oraz informacji przekazywanych przez Google po zarejestrowaniu aplikacji (takich jak identyfikator klienta i tajny klucz klienta).

Wskazówka: biblioteki klienta interfejsów API Google mogą wykonać niektóre procesy autoryzacji za Ciebie. Są dostępne dla różnych języków programowania. Więcej szczegółów znajdziesz na stronie z bibliotekami i próbkami.

Uzyskiwanie i używanie klucza interfejsu API

Żądaniem interfejsów API Bloggera do zbierania danych publicznych musi być powiązany identyfikator, który może być kluczem interfejsu API lub tokenem dostępu.

Pobieranie klucza

Możesz też utworzyć je na stronie Dane logowania.

Gdy uzyskasz klucz interfejsu API, aplikacja może dołączać parametr zapytania key=yourAPIKey do wszystkich adresów URL żądań.

Klucz interfejsu API można bezpiecznie umieszczać w adresach URL, więc nie trzeba go kodować.

Praca z blogami

Pobieranie bloga

Informacje o tym blogu możesz pobrać, wysyłając żądanie HTTP GET do identyfikatora URI tego bloga. Identyfikator URI bloga ma następujący format:

https://www.googleapis.com/blogger/v3/blogs/blogId

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/2399953?key=YOUR-API-KEY

Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i dane bloga:

{
  "kind": "blogger#blog",
  "id": "2399953",
  "name": "Blogger Buzz",
  "description": "The Official Buzz from Blogger at Google",
  "published": "2007-04-23T22:17:29.261Z",
  "updated": "2011-08-02T06:01:15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

Pobieranie bloga według adresu URL

Możesz pobrać bloga za pomocą jego adresu URL, wysyłając żądanie HTTP GET do tego identyfikatora URI za pomocą parametru url:

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

Żądanie

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i pełną reprezentację zidentyfikowanego bloga:

{
 "kind": "blogger#blog",
 "id": "3213900",
 "name": "Blogger Developers Network",
 "description": "The official Blogger Developers Network weblog.",
 "published": "2007-02-09T10:13:10-08:00",
 "updated": "2012-04-15T19:38:01-07:00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900",
 "posts": {
  "totalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts"
 },
 "pages": {
  "totalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages"
 },
 "locale": {
  "language": "en",
  "country": "US",
  "variant": ""
 }
}

Pobieranie blogów użytkownika

Możesz pobrać listę blogów użytkownika, wysyłając żądanie HTTP GET do identyfikatora URI kolekcji blogów:

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

Żądanie

GET https://www.googleapis.com/blogger/v3/users/self/blogs
Authorization: /* OAuth 2.0 token here */

Uwaga: użytkownik musi być uwierzytelniony, aby wyświetlić listę własnych blogów, więc musisz udostępnić nagłówek HTTP Authorization w żądaniu GET.

Odpowiedź

Jeśli żądanie się powiedzie, serwer wyśle kod stanu HTTP 200 OK i pełną reprezentację listy blogów użytkownika:

{
  "kind": "blogger#blogList",
  "items": [
    {
      "kind": "blogger#blog",
      "id": "4967929378133675647",
      "name": "Brett's Test Blawg",
      "description": "",
      "published": "2010-10-06T23:33:31.662Z",
      "updated": "2011-08-08T06:50:02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

Praca z postami

Pobieranie postów z bloga

Możesz pobrać listę postów z danego bloga, wysyłając żądanie GET do identyfikatora URI kolekcji postów. Identyfikator URI kolekcji postów ma taki format:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Żądanie

Oto przykład.

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts?key=YOUR-API-KEY

Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i listę postów:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "items": [
    {
      "kind": "blogger#post",
      "id": "7706273476706534553",
      "blog": {
        "id": "2399953"
      },
      "published": "2011-08-01T19:58:00.000Z",
      "updated": "2011-08-01T19:58:51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
      "title": "Latest updates, August 1st",
      "content": "elided for readability",
      "author": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "image": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "replies": {
        "totalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

Pobieranie konkretnego posta

Możesz pobrać określonego posta z bloga, wysyłając żądanie GET do identyfikatora URI zasobu postów. Identyfikator URI zasobu postów ma taki format:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553?key=YOUR-API-KEY

Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Wyszukuję posta

Możesz wyszukiwać posty z bloga, wysyłając żądanie GET do identyfikatora URI wyszukiwania postów za pomocą parametru zapytania „q”:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "items": [
  {
    "kind": "blogger#post",
    "id": "1387873546480002228",
    "blog": {
      "id": "3213900"
    },
    "published": "2012-03-23T01:58:00-07:00",
    "updated": "2012-03-23T01:58:12-07:00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228",
    "title": "Blogger Documentation has moved to developers.google.com",
    "content": "content elided for readability",
    "author": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "image": {
        "url": "https://resources.blogblog.com/img/b16-rounded.gif"
      }
    },
    "replies": {
      "totalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

Dodawanie posta

Możesz dodać posta do bloga, wysyłając żądanie POST do identyfikatora URI kolekcji postów z treścią posta w formacie JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/

Żądanie

POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
  "kind": "blogger#post",
  "blog": {
    "id": "8070105920543249955"
  },
  "title": "A new post",
  "content": "With <b>exciting</b> content..."
}

Aby utworzyć posta, musisz się uwierzytelnić.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "A new post",
 "content": "With <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Usuwanie posta

Możesz usunąć posta na blogu, wysyłając żądanie DELETE do identyfikatora URI zasobu posta:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Żądanie

Oto przykład.

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

Aby usunąć posta, musisz się uwierzytelnić.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK.

Pobieranie posta według ścieżki

Możesz pobrać posta z bloga, wysyłając żądanie GET do identyfikatora URI postów przy użyciu parametru path. Identyfikator URI postów w żądaniu o ścieżce ma następujący format:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

Żądanie

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Aktualizowanie posta

Możesz zaktualizować posta na blogu, wysyłając żądanie PUT do identyfikatora URI zasobu posta z treścią posta w formacie JSON:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Żądanie

PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "kind": "blogger#post",
 "id": "3445355871727114160",
 "blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content..."
}

Aby zaktualizować posta, musisz się uwierzytelnić.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Aktualizowanie posta z semantyką poprawki

Możesz zaktualizować post za pomocą semantyki poprawki, wysyłając żądanie PATCH do identyfikatora URI zasobu posta z treścią JSON posta:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId

Żądanie

Oto przykład.

PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "content": "With absolutely <b>fabulous</b> content..."
}

Aby zaktualizować posta, musisz się uwierzytelnić.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i treści posta:

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With absolutely <b>fabulous</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

Praca z komentarzami

Pobieranie komentarzy do posta

Listę komentarzy do posta możesz pobrać, wysyłając żądanie GET do identyfikatora URI kolekcji komentarzy. Identyfikator URI kolekcji komentarzy ma ten format:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments?key=YOUR-API-KEY

"Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie się powiedzie, serwer wyśle kod stanu HTTP 200 OK i listę komentarzy:

{
  "kind": "blogger#commentList",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "items": [
    {
       "kind": "blogger#comment",
       "id": "9200761938824362519",
       "post": {
         "id": "6069922188027612413"
       },
       "blog": {
         "id": "2399953"
       },
       "published": "2011-07-28T19:19:57.740Z",
       "updated": "2011-07-28T21:29:42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "content": "elided",
       "author": {
         "id": "530579030283",
         "displayName": "elided",
         "url": "elided",
         "image": {
           "url": "elided"
         }
       }
    },
    {
      "kind": "blogger#comment",
      "id": "400101178920857170",
      elided for readability
    }
  ]
}

Pobieranie konkretnego komentarza

Możesz pobrać określony komentarz z posta, wysyłając żądanie GET do identyfikatora URI zasobu komentarzy. Identyfikator URI zasobu komentarzy ma następujący format:

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/postId/comments/commentId

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519?key=YOUR-API-KEY

"Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i dane komentarza:

{
  "kind": "blogger#comment",
  "id": "9200761938824362519",
  "post": {
    "id": "6069922188027612413"
  },
  "blog": {
    "id": "2399953"
  },
  "published": "2011-07-28T19:19:57.740Z",
  "updated": "2011-07-28T21:29:42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

Praca ze stronami

Pobieram strony bloga

Listę stron bloga możesz pobrać, wysyłając żądanie GET do identyfikatora URI kolekcji stron. Identyfikator URI kolekcji stron ma taki format:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages?key=YOUR-API-KEY

"Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i listę stron:

{
  "kind": "blogger#pageList",
  "items": [
    {
      "kind": "blogger#page",
      "id": "273541696466681878",
      "blog": {
        "id": "4967929378133675647"
      },
      "published": "2011-07-14T16:16:00.000Z",
      "updated": "2011-07-14T16:16:23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
      "title": "Static Content",
      "content": "elided for readability",
      "author": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "image": {
          "url": "https://resources.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

Pobieranie konkretnej strony

Aby pobrać konkretną stronę z bloga, wyślij żądanie GET do identyfikatora URI zasobu stron. Identyfikator URI stron ma taki format:

https://www.googleapis.com/blogger/v3/blogs/blogId/pages/pageId

Żądanie

GET https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878?key=YOUR-API-KEY

"Użytkownik nie musi być uwierzytelniony, aby pobrać bloga publicznego. Aplikacja nie musi uwzględniać nagłówka HTTP Authorization w żądaniu publicznego bloga, ale musisz podać klucz interfejsu API.

W Bloggerze znajdują się też prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wyśle kod stanu HTTP 200 OK i dane strony:

{
  "kind": "blogger#page",
  "id": "273541696466681878",
  "blog": {
    "id": "4967929378133675647"
  },
  "published": "2011-07-14T16:16:00.000Z",
  "updated": "2011-07-14T16:16:23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages/273541696466681878",
  "title": "Static Content",
  "content": "elided for readability",
  "author": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "image": {
      "url": "https://resources.blogblog.com/img/b16-rounded.gif"
    }
  }
}

Praca z użytkownikami

Pobieranie konta użytkownika

Aby pobrać informacje o użytkowniku, wyślij żądanie HTTP GET do identyfikatora URI zasobu użytkownika:

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

Żądanie

GET https://www.googleapis.com/blogger/v3/users/self
Authorization: /* OAuth 2.0 token here */

Uwaga: użytkownik musi być uwierzytelniony, aby wyświetlić własne informacje, dlatego musisz udostępnić nagłówek HTTP Authorization w żądaniu GET.

Odpowiedź

Jeśli żądanie się powiedzie, serwer wyśle kod stanu HTTP 200 OK i link do listy blogów użytkownika:

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v3/users/901569848744/blogs"
  }
}

Standardowe parametry zapytania

Podane poniżej parametry zapytania mogą być używane w przypadku wszystkich metod i wszystkich zasobów w interfejsach API Bloggera.

Parametry zapytania, które mają zastosowanie do wszystkich operacji interfejsu API Bloggera, są wymienione w artykule Parametry systemowe.