Interfejs API Bloggera: korzystanie z interfejsu API

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

Wstęp

Ten dokument jest przeznaczony dla programistów, którzy chcą tworzyć aplikacje wchodzące w interakcje z interfejsem API Bloggera. Blogger to narzędzie do tworzenia witryn, które pozwalają użytkownikom na bieżąco publikować swoje przemyślenia.

Jeśli nie znasz pojęcia Bloggera, zanim zaczniesz pisać kod, przeczytaj Pierwsze kroki.

Autoryzacja żądań i identyfikowanie aplikacji

Każde żądanie wysyłane przez aplikację do interfejsów API Bloggera musi identyfikować Twoją aplikację w Google. Są 2 sposoby identyfikowania aplikacji: za pomocą tokena OAuth 2.0 (który również autoryzuje żądanie) lub za pomocą klucza interfejsu API aplikacji. Oto jak zdecydować, której z tych opcji użyć:

• Jeśli żądanie wymaga autoryzacji (np. dostępu do prywatnych danych danej osoby), aplikacja musi dostarczyć wraz z nim token OAuth 2.0. Aplikacja może też dostarczać klucz interfejsu API, ale nie musi.
• Jeśli żądanie nie wymaga autoryzacji (np. danych publicznych), aplikacja musi dostarczyć klucz interfejsu API lub token OAuth 2.0 albo obie te opcje – która opcja jest dla Ciebie najwygodniejsza.

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 dotyczące niepublicznych danych użytkownika wysyłane do interfejsów API Bloggera muszą być autoryzowane przez uwierzytelnionego użytkownika.

Ten proces odbywa się za pomocą identyfikatora klienta OAuth.

Uzyskaj identyfikator 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.

Oto informacje o zakresie protokołu OAuth 2.0 dla 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

Żądania dotyczące danych publicznych wysyłane do interfejsów API Bloggera muszą towarzyszyć identyfikatorami, którymi może być klucz interfejsu API lub token dostępu.

Kup klucz

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

Gdy uzyskasz klucz interfejsu API, Twoja 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

Aby pobrać informacje o konkretnym blogu, wyślij do jego identyfikatora URI żądanie HTTP GET. Identyfikator URI bloga ma następujący format:

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

Prośba

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

Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniany. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowie, wysyłając 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 z parametrem url:

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

Prośba

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

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowie, przesyłając 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

Aby pobrać listę blogów użytkownika, wyślij żądanie HTTP GET do identyfikatora URI kolekcji blogów:

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

Prośba

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

Uwaga: aby móc wyświetlać własne blogi, użytkownik musi być uwierzytelniony, więc wraz z żądaniem GET musisz dostarczyć nagłówek HTTP Authorization.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer w odpowiedzi przesyła 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

Aby pobrać listę postów z danego bloga, wyślij żądanie GET do identyfikatora URI kolekcji postów. Identyfikator URI kolekcji postów ma następujący format:

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

Prośba

Oto przykład:

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

Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniany. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowie, przesyłając 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ć konkretnego posta z bloga, wysyłając żądanie GET do identyfikatora URI zasobu postów. Identyfikator URI zasobu postów ma następujący format:

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

Prośba

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

Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniany. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowiada kodem 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"
  }
}

Wyszukiwanie posta

Aby wyszukiwać posty na blogu, wyślij żądanie GET do identyfikatora URI wyszukiwania postów, używając parametru zapytania q:

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

Prośba

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

Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniany. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowiada kodem 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

Aby dodać posta na blogu, wyślij żądanie POST do identyfikatora URI kolekcji postów z treścią w formacie JSON:

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

Prośba

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 odpowiada kodem 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

Aby usunąć posta na blogu, wyślij żądanie DELETE do identyfikatora URI zasobu posta:

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

Prośba

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 zwróci kod stanu HTTP 200 OK.

Pobieranie posta według jego ścieżki

Możesz pobrać posta z bloga, wysyłając żądanie GET do identyfikatora URI postów według ścieżki, używając parametru path. Identyfikator URI żądania postów według ścieżki ma ten format:

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

Prośba

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

Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniany. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowiada kodem 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ą w formacie JSON:

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

Prośba

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 odpowiada kodem 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 semantyki posta z użyciem poprawki

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

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

Prośba

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 odpowiada kodem 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

Aby pobrać listę komentarzy do posta, wyślij żądanie GET do identyfikatora URI kolekcji komentarzy. Identyfikator URI kolekcji komentarzy ma następujący format:

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

Prośba

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

„Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniony. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowie, przesyłając 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

Aby pobrać konkretny komentarz z posta, wyślij żądanie GET do identyfikatora URI zasobu komentarzy. Identyfikator URI zasobu komentarzy ma taki format:

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

Prośba

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

„Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniony. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer odpowie, przesyłając 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

Pobieranie stron dla bloga

Możesz pobrać listę stron bloga, wysyłając żądanie GET do identyfikatora URI kolekcji stron. Identyfikator URI kolekcji stron ma następujący format:

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

Prośba

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

„Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniony. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wysyła w odpowiedzi 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

Możesz pobrać konkretną stronę z bloga, wysyłając żądanie GET do identyfikatora URI zasobu stron. Identyfikator URI strony Zasób ma następujący format:

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

Prośba

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

„Aby pobrać publicznego bloga, użytkownik nie musi być uwierzytelniony. Aplikacja nie musi zawierać nagłówka HTTP Authorization w przypadku publicznego żądania bloga, ale musisz podać klucz interfejsu API.

Blogger ma również prywatne blogi, które wymagają uwierzytelnienia.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer zwróci 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

Prośba

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

Uwaga: aby móc wyświetlić własne informacje, użytkownik musi być uwierzytelniony, dlatego wraz z żądaniem GET musisz dostarczyć nagłówek HTTP Authorization.

Odpowiedź

Jeśli żądanie zostanie zrealizowane, serwer wysyła w odpowiedzi 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

Wymienionych poniżej parametrów zapytania można używać ze wszystkimi metodami i zasobami w interfejsach API Bloggera.

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