Nachrichten-Center Infos mithilfe unserer API

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)

Montag, 15. Dezember 2008 um 11:13