PHP-Beispiele
Überblick
Alle Codebeispiele in diesem Abschnitt verwenden die folgenden Klassen.
Die Request-Klasse verwendet cURL um die Anfragen an die API zu stellen.
Die Response-Klasse enthält die API-Antwort und Informationen zum zurückgegebenen Statuscode.
Anmelden
Es gibt zwei Möglichkeiten, die Anmeldung Route:
mit Benutzername und Passwort
mit API-Token (Access-Token)
Beispiel für die Anmeldung mit Benutzername- und Passwort-Parametern.
<?php
// Request- und Response-Klassen einbinden
$url = 'https://api.example.com/v2/login';
$params = array(
'username' => 'sample_username',
'password' => 'sample_password'
);
// Ein neues Request-Objekt erstellen
$request = new Request($url, 'POST', $params);
// Die Anfrage senden
$request->send();
// Das Response-Objekt abrufen
$response = $request->getResponse();
if($response->getStatusCode() == 200) {
// Die Details des Session-Tokens abrufen
$token = $response->getBodyDecoded();
print_r($token);
}
else {
echo $response->getStatusCode() . PHP_EOL;
echo $response->getReasonPhrase() . PHP_EOL;
echo $response->getBody() . PHP_EOL;
}
?>Beispiel für die Anmeldung mit API-Token (Access-Token)
Authentifizierung
Jede Anfrage an benutzerbezogene Inhalte erfordert einen Autorisierung Header, dessen Wert den Token-Typ und den von der API-Login-Anfrage erhaltenen Session-Token enthält.
Eine gültige /login Anfrage an die API liefert den folgenden JSON-Payload zurück.
Die Session-Token sollte in alle nachfolgenden Anfragen an die API zu benutzerbezogenen Inhalten aufgenommen werden.
Die type ist dem Token voranzustellen, getrennt durch ein einzelnes Leerzeichen.
Die expires_in ist die Zeit in Sekunden, für die das Token gültig ist. Wenn diese Zeit abläuft, muss über die /login-Anfrage ein neues Token angefordert werden.
Beispiel zum Abrufen und Setzen des Authorization-Headers mit Benutzername und Passwort
Beispiel zum Abrufen und Setzen des Authorization-Headers mit API-Token
Sammlungen
Das Folgende ist ein Beispiel für eine Anfrage zum Abrufen der Browser Sammlung.
Statistiken
Das folgende ist ein Beispiel für eine Anfrage eines Werbetreibenden an statistics/a/date.
Falls additional_group_by der Wert definiert ist, wird die Anfrage nach dem Haupt-Routenfeld und den zusätzlichen Feld(en) gruppiert.
Beispiel für Statistiken pro Datum, gefiltert nach Kampagnen-ID 1234.
Beispiel für Statistiken pro Datum mit zusätzlicher Gruppierung nach Kampagne.
post /statistics/a/global
Globale Werbetreibenden-Statistiken abrufen
Beispiel 1 für globale Statistiken
Beispiel für eine Anfrage globaler Statistiken.
Nur der group_by Parameter ist obligatorisch. Die Standardwerte für die anderen Parameter finden Sie Hier.
Bitte beachten Sie, dass die Routen für globale Statistiken (statistics/a/global, statistics/p/global) ein anderes Parameterformat haben.
Beispiel 2 für globale Statistiken
Statistiken pro Datum abrufen, einschließlich Gesamtsummen.
Beispiel 3 für globale Statistiken
Statistiken pro Kampagne und Land abrufen, gefiltert nach einem bestimmten Datum und nach Impressionen sortiert.
Beispiel 4 für globale Statistiken
Publisher-Statistiken pro Zone und Land abrufen, gefiltert nach einem bestimmten Betriebssystem.
Zuletzt aktualisiert
War das hilfreich?
