Nachrichten-Center Infos mithilfe unserer API

Montag, 15. Dezember 2008

Wir haben neulich einige Updates in unserer Webmaster-Tools GData-API angesprochen : Jetzt haben wir eine gänzlich neue API veröffentlicht, die Nachrichten-Center GData-API, die ein Teil der Webmaster-Tools-API ist. Das Nachrichten-Center ist der Kommunikationskanal, über den euch Google wichtige Informationen zu eurer Site mitteilt - falls es z. B. Crawling-Probleme bei eurer Site gab, oder falls eine Änderung der Crawling-Geschwindigkeit beantragt wurde. Bislang war es ausschließlich über das Nachrichten-Center der Webmaster-Tools möglich, diese Informationen abzurufen - jetzt könnt ihr sie mittels GData auch als Feed beziehen. Bei dieser Methode ist es nicht mehr erforderlich, die Nachrichten regelmäßig in den Webmaster-Tools zu lesen, da ihr einen entsprechenden Nachrichten-Feed automatisch beziehen könnt, um unmittelbar über möglicherweise wichtige Nachrichten zu eurer Site informiert zu sein.

Was könnt ihr tun?

Über die Nachrichten-Center GData-API könnt ihr alle Nachrichten empfangen, sie als gelesen oder ungelesen markieren und ebenso auch löschen. Dies alles könnt ihr ausführen, indem ihr unsere Java-Client-Bibliotheken verwendet oder eigenen Client-Code anhand unserer Protokoll-Spezifikationen erstellt.
  • Nachrichten abrufen : Der Nachrichten-Feed beinhaltet alle Nachrichten, die an euer Webmaster-Tools-Konto geschickt wurden. Diese Nachrichten enthalten wichtige Informationen zu den von euch registrierten Sites. Beispielsweise kann es sich hierbei um Warnungen zu "endlosen Weiten" oder Benachrichtigungen zu geänderten Crawling-Geschwindigkeiten handeln.
  • Nachrichten als gelesen/ungelesen markieren : Um den Überblick über die Nachrichten von Google zu behalten, könnt ihr Nachrichten als gelesen oder ungelesen markieren, genau wie beim E-Mail Posteingang. Wenn ihr eine einzelne Nachricht abruft, wird diese automatisch als "gelesen" gekennzeichnet.
  • Nachrichten löschen : Ihr könnt Nachrichten mittels der GData-API auch löschen. Jedoch solltet ihr dabei vorsichtig sein, denn alle Nachrichten, die ihr über die API löscht, werden automatisch auch aus eurem Webmaster-Tools-Konto entfernt, da beide Schnittstellen auf die gleichen Daten zugreifen.
Wie könnt ihr das tun?

Ihr könnt unsere Java-Code-Beispiele herunterladen, um alle neuen Features zu sehen. Diese Beispiele zeigen einfache Methoden, um den Nachrichten-Feed zu nutzen. Der folgende Code-Ausschnitt zeigt, wie ihr den Nachrichten-Feed in einer der unterstützten Sprachen abrufen und anzeigen könnt:

// Connect with the service and authenticate
WebmasterToolsService service
=
new WebmasterToolsService( "exampleCo-exampleApp-1" );
try {
service.setUserCredentials(
USERNAME , PASSWORD );
}
catch (AuthenticationException e) {
System.out.println(
"Username or password invalid" );
return ;
}

// Retrieve messages feed
MessagesFeed messages;
try {
URL feedUrl;
if ( USER_LANGUAGE == null ) {
feedUrl =
new URL( MESSAGES_FEED_URI );
}
else {
feedUrl =
new URL( MESSAGES_FEED_URI
+
"?hl=" + USER_LANGUAGE );
}
messages = service.getFeed(feedUrl, MessagesFeed.
class );
}
catch (IOException e) {
System.out.println(
"There was a network error." );
return ;
}
catch (ServiceException e) {
System.out.println(
"The service is not available." );
return ;
}

// Print the messages feed
System.out.println(messages.getTitle().getPlainText());
for (MessageEntry entry : messages.getEntries()) {
if (entry.getRead()) {
System.out.print(
"   \t" );
}
else {
System.out.print(
"new\t" );
}
System.out.print(entry.getDate().toUiString() +
"\t" );
System.out.println(entry.getSubject());
}

Wo gibt es weitere Informationen?
Wenn ihr mehr über GData erfahren möchtet, bietet es sich an, die GData-Website zu besuchen. Auf der Homepage der Webmaster-Tools GData-API gibt es einen Bereich zum Thema "Nachrichten-Feed" mit weiteren Details zum zugrunde liegenden Protokoll. Ihr könnt euch auch ein Beispiel eines Nachrichten-Center Clients von der GData Download-Site herunterladen. Dort wird euch gezeigt, wie ihr alle Features der Nachrichten-Center-API nutzen könnt.

Message Center info through our API (English version)

Post von Javier Tordable, Software-Ingenieur (Übersetzung von Sven, Search Quality)