Diese Seite wurde von der Cloud Translation API übersetzt.

Blogger JSON API: API verwenden

Wichtig: Die Unterstützung für die JSON API 2.0 wird am 30. September 2024 eingestellt. Aktualisieren Sie Ihre Anwendungen, die auf der v2.0 JSON API basieren, damit die Funktionalität weiterhin gewährleistet ist. auf die neueste API-Version. Die aktuelle Version erhalten Sie über die Links in der Navigationsleiste auf der linken Seite.

In diesem Dokument wird beschrieben, wie die allgemeinen Funktionen der Blogger JSON API mithilfe des RESTful-Aufrufstils verwendet werden.

Inhalt

Einführung
1. Anfragen autorisieren und Ihre Anwendung identifizieren
Mit Blogs arbeiten
1. Blog abrufen
2. Blogs eines Nutzers abrufen
Beiträge verwenden
1. Beiträge für einen Blog abrufen
2. Bestimmten Beitrag abrufen
Mit Kommentaren arbeiten
1. Kommentare zu einem Beitrag abrufen
2. Bestimmte Kommentare abrufen
Mit Seiten arbeiten
1. Seiten für einen Blog abrufen
2. Bestimmte Seite abrufen
Zusammenarbeit mit Nutzern
1. Nutzer abrufen
Standardabfrageparameter

Einführung

Dieses Dokument richtet sich an Entwickler, die Anwendungen erstellen möchten, mit der Blogger JSON API interagieren können. Blogger ist ein Tool für Websites erstellen, die es den Menschen ermöglichen, ihre Gedanken zu verstehen.

Wenn Sie mit den Konzepten von Blogger nicht vertraut sind, sollten Sie zuerst den Artikel Erste Schritte lesen, bevor Sie mit dem Programmieren beginnen.

Anfragen autorisieren und Ihre Anwendung identifizieren

Jede Anfrage, die Ihre Anwendung an die Blogger JSON API sendet, muss Ihre Anwendung gegenüber Google zu identifizieren. Dafür gibt es zwei Möglichkeiten: die Verwendung eines OAuth 2.0-Tokens, das auch die Anfrage autorisiert, und/oder die Verwendung des API-Schlüssels der Anwendung. Hier erfahren Sie, welche dieser Optionen verwenden:

Wenn die Anfrage eine Autorisierung erfordert, beispielsweise für private Daten einer Person, muss die Anwendung ein OAuth 2.0-Token mit der Anfrage bereitstellen. Die Anwendung kann auch den API-Schlüssel bereitstellen, dies ist jedoch nicht notwendig.
Wenn für die Anfrage keine Autorisierung erforderlich ist (z. B. um eine öffentliche enthält, muss die Anwendung entweder den API-Schlüssel oder OAuth 2.0 Tokens oder beides an, je nachdem, welche Option für Sie am besten geeignet ist.

Autorisierungsprotokolle

Ihre Anwendung muss OAuth 2.0 verwenden. um Anfragen zu autorisieren. Andere Autorisierungsprotokolle werden nicht unterstützt.

Hinweis: Die Blogger JSON API unterstützt derzeit keine Protokollierung. gleichzeitig mit der Anforderung des Datenzugriffs (Hybrid) oder domainweit Delegierung der Befugnis (2LO).

Anfragen mit OAuth 2.0 autorisieren

Anfragen an die Blogger JSON API für nicht öffentliche Nutzerdaten müssen autorisiert sein von einem authentifizierten Nutzer.

Die Details des Autorisierungsprozesses für OAuth 2.0 variieren. je nachdem, welche Art von Anwendung Sie schreiben. Die folgenden allgemeine Vorgehensweise gilt für alle Anwendungstypen:

Wenn Sie eine Anwendung erstellen, registrieren Sie diese bei Google. Google stellt Ihnen dann die Informationen bereit, die Sie später benötigen, z. B. eine Client-ID und einen Clientschlüssel.
Aktivieren Sie die Blogger JSON API im Bereich „Dienste“ der Google APIs Console. Überspringen Sie diesen Schritt, falls sie nicht in der Konsole aufgeführt ist.
Wenn Ihre Anwendung Zugriff auf Nutzerdaten benötigt, wird Google nach einer Zugriffsumfang.
Dem Nutzer wird von Google ein OAuth-Dialogfeld angezeigt, auf dem er gebeten wird, Ihre Anwendung dazu zu autorisieren, einige seiner Daten abzufragen.
Wenn der Nutzer zustimmt, erhält Ihre Anwendung von Google ein kurzlebiges Zugriffstoken.
Ihre Anwendung fordert Nutzerdaten an und das Zugriffstoken wird an die
Stellt Google fest, dass Ihre Anfrage und das Token gültig sind, werden die angeforderten Daten zurückgegeben.

Einige Abläufe umfassen zusätzliche Schritte, z. B. die Verwendung von Refresh- Tokens, um neue Zugriffstokens zu erhalten. Weitere Informationen über die Abläufe für die unterschiedlichen Anwendungstypen findest du in der OAuth 2.0-Dokumentation.

Im Folgenden finden Sie die Informationen zum OAuth 2.0-Bereich für die Blogger JSON API:

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

Zur Anforderung eines Zugriffs mit OAuth 2.0 benötigt Ihre Anwendung die Bereichsinformationen sowie die Informationen, die Google bei der Registrierung Ihrer Anwendung bereitstellt, z. B. die Client-ID und/oder den Clientschlüssel.

Tipp: Die Google APIs-Clientbibliotheken können einige Schritte des Autorisierungsvorgangs für Sie übernehmen. Sie sind für eine in verschiedenen Programmiersprachen, finden Sie auf der Seite Bibliotheken und Beispiele erhalten Sie weitere Informationen.

API-Schlüssel erhalten und nutzen

Bei Anfragen an die Blogger JSON API nach öffentlichen Daten muss ein ID, bei der es sich um einen API-Schlüssel oder ein Authentifizierungstoken handeln kann.

Einen API-Schlüssel erhalten Sie in der APIs Console. Aktivieren Sie im Bereich „Dienste“ die [api_name]. Wenn die Nutzungsbedingungen angezeigt werden, lesen Sie sie und akzeptieren Sie sie.

Rufen Sie als Nächstes den Bereich API-Zugriff auf. Der API-Schlüssel befindet sich unten im Bereich „Einfacher API-Zugriff“.

Sobald Sie einen API-Schlüssel haben, kann Ihre Anwendung den Suchparameter anhängen key=yourAPIKey für alle Anfragen URLs.

Der API-Schlüssel lässt sich sicher in URLs einbetten. Eine Codierung ist nicht notwendig.

Arbeiten mit Blogs

Abrufen eines Blogs

Sie können Informationen für eine bestimmte Blogressource abrufen, indem Sie eine HTTP-GET-Anfrage an den URI des Blogs senden. Der URI für eine Blogs-Ressource hat das folgende Format:

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

Anfrage

Hier ein Beispiel:

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

Da ein Nutzer zum Abrufen eines öffentlichen Blogs nicht authentifiziert sein muss, haben Sie müssen dabei nicht den Authorization-HTTP-Header GET-Anfrage; Ohne diesen Header müssen Sie einen API-Schlüssel angeben.

Blogger verfügt auch über private Blogs, für die jedoch Authentifizierung.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit einem 200 OK-Statuscode und die Blogdaten:

200 OK

{
  "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/v2/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

Abrufen der Blogs eines Nutzers

Du kannst eine Liste der Blogs eines Nutzers abrufen, indem du eine HTTP-GET-Anfrage sendest. an den URI der Blogs-Sammlung an:

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

Anfrage

Hier ist ein Beispiel für eine GET-Anfrage, in der ein Blogs des Nutzers:

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

Hinweis: Der Nutzer muss für Folgendes authentifiziert sein: eigene Blogs auflisten, sodass Sie das Authorization-HTTP-Protokoll mit der GET-Anfrage.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und der vollständigen Liste der Blogs des Nutzers:

200 OK

{
  "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/v2/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

Mit Beiträgen arbeiten

Posts aus einem Blog abrufen

Du kannst eine Liste der Beiträge eines bestimmten Blogs abrufen, indem du eine GET-Anfrage an den URI der Beitragssammlung sendest. Der URI für eine Sammlung von Beiträgen hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Da ein Nutzer nicht authentifiziert sein muss, um die Posts aus einem öffentlichen Blog abzurufen, müssen dabei nicht den Authorization-HTTP-Header GET-Anfrage; Ohne diesen Header müssen Sie einen API-Schlüssel angeben.

Blogger verfügt auch über private Blogs, für die jedoch Authentifizierung.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und der Liste der Beiträge:

200 OK

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "prevPageToken": "CgkIChDBwrK3mCYQ0b2SAQ",
  "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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

Einen bestimmten Beitrag abrufen

Sie können einen bestimmten Post aus einem Blog abrufen, indem Sie eine GET-Anfrage an den URI der Ressource vom Typ „Posts“. Der URI für eine Beitragsressource hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Blogger verfügt auch über private Blogs, für die jedoch Authentifizierung.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit einem 200 OK-Statuscode und Inhalt des Beitrags:

200 OK

{
  "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/v2/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/v2/blogs/2399953/posts/7706273476706534553/comments"
  }
}

Mit Kommentaren arbeiten

Kommentare zu einem Beitrag abrufen

Du kannst eine Liste der Kommentare zu einem Beitrag abrufen, indem du eine GET-Anfrage an den URI der Kommentarsammlung sendest. Der URI für eine Kommentarsammlung hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Da ein Nutzer nicht authentifiziert sein muss, um die Kommentare aus einem öffentlichen Blog abzurufen, können Sie müssen dabei nicht den Authorization-HTTP-Header GET-Anfrage; Ohne diesen Header müssen Sie einen API-Schlüssel angeben.

Blogger verfügt auch über private Blogs, für die jedoch Authentifizierung.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und der Liste der Kommentare:

200 OK

{
  "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/v2/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
    }
  ]
}

Einen bestimmten Kommentar abrufen

Du kannst einen bestimmten Kommentar aus einem Beitrag abrufen, indem du eine GET-Anfrage an die URI der Kommentarressource sendest. Der URI für eine Kommentarressource hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Blogger verfügt auch über private Blogs, für die jedoch Authentifizierung.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und den Kommentardaten:

200 OK

{
  "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/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

Mit Seiten arbeiten

Seiten für ein Blog abrufen

Sie können eine Liste mit Seiten für ein Blog abrufen, indem Sie eine GET-Anfrage an den URI der Seitensammlung. Der URI für eine Seitensammlung hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Da ein Nutzer nicht authentifiziert sein muss, um die Seiten aus einem öffentlichen Blog abzurufen, müssen dabei nicht den Authorization-HTTP-Header GET-Anfrage; Ohne diesen Header müssen Sie einen API-Schlüssel angeben.

Blogger bietet auch private Blogs an, für die eine Authentifizierung erforderlich ist.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und der Liste der Seiten:

200 OK

{
  "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/v2/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"
        }
      }
    }
  ]
}

Bestimmte Seite abrufen

Sie können eine bestimmte Seite aus einem Blog abrufen, indem Sie eine GET-Anfrage an den URI der Seitenressource. Der URI für eine Google Tabellen-Ressource hat folgendes Format:

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

Anfrage

Hier ein Beispiel:

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

Blogger bietet auch private Blogs an, für die eine Authentifizierung erforderlich ist.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit einem 200 OK-Statuscode und die Seitendaten:

200 OK

{
  "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/v2/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"
    }
  }
}

Mit Nutzern arbeiten

Nutzer abrufen

Sie können die Informationen eines Nutzers abrufen, indem Sie eine HTTP-GET-Anfrage an die URI der Nutzerressource senden:

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

Anfrage

Hier ist ein Beispiel für eine GET-Anfrage, die die Blogs eines Nutzers auflistet:

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

Hinweis: Der Nutzer muss authentifiziert sein, um seine eigenen Informationen aufzulisten. Daher müssen Sie den Authorization-HTTP-Header mit der GET-Anfrage angeben.

Antwort

Wenn die Anfrage erfolgreich ist, antwortet der Server mit dem HTTP-Statuscode 200 OK und einem Link zu einer Liste der Blogs des Nutzers:

200 OK

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

Standardabfrageparameter

Die folgenden Abfrageparameter können mit allen Methoden und Ressourcen in den Blogger-APIs verwendet werden.

Abfrageparameter, die für alle Blogger API-Vorgänge gelten, sind unter dokumentiert. Systemparameter.