Zum Hauptinhalt springen

Einführung

Google Search ist ein von Ace Data Cloud bereitgestellter Suchdienst, die Google Search API. Über die einheitliche API von Ace Data Cloud können Sie Google Search mit JavaScript schnell integrieren und Funktionen wie Websuche, Bildsuche, Nachrichtensuche, Kartensuche und Videosuche realisieren.

Voraussetzungen

  • Ein Konto bei Ace Data Cloud und ein API-Token
  • Node.js 18+ oder eine moderne Browserumgebung

Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Google Search API lautet:
POST https://api.acedata.cloud/serp/google
Vollständiges JavaScript-Beispiel:
const response = await fetch("https://api.acedata.cloud/serp/google", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "query": "artificial intelligence latest news",
  "type": "search",
  "number": 10,
  "language": "en",
  "country": "US"
}),
});

const result = await response.json();
console.log(result);
Ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

Antwortverarbeitung

Es wird empfohlen, den Statuscode der Antwort zu prüfen und Fehler zu behandeln:
if (response.ok) {
  const result = await response.json();
  console.log("Aufruf erfolgreich:", result);
} else {
  console.error(`Aufruf fehlgeschlagen, Statuscode: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Node.js Wrapper

Es wird empfohlen, eine wiederverwendbare Funktion zu erstellen:
async function callGoogleSearch(data) {
  const response = await fetch("https://api.acedata.cloud/serp/google", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API Fehler: ${response.status}`);
  return response.json();
}

Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API-Token prüfen
403Unzureichendes Guthaben oder kein Zugriff
429Anfragelimit überschritten
500Interner Serverfehler

Nächste Schritte