Grundlegende Nutzung

Die grundlegende Verwendung der Clientbibliothek sieht so aus:

use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\Lib\V26\GoogleAdsClientBuilder;

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file and the
// OAuth 2.0 credentials.
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    // Replace 1234567890 with your login customer ID.
    ->withLoginCustomerId(1234567890)
    ->build();

// Create the CampaignServiceClient.
$campaignServiceClient = $googleAdsClient->getCampaignServiceClient();

// Make calls to CampaignServiceClient.

Client und Dienst initialisieren

Wenn Sie Anfragen an die Google Ads API senden möchten, initialisieren Sie zuerst eine Clientinstanz und erstellen Sie dann damit einen Dienstclient.

GoogleAdsClient-Instanz erstellen

Die wichtigste Klasse in der Google Ads API-PHP-Bibliothek ist die Klasse GoogleAdsClient. Damit können Sie vorkonfigurierte Dienstclientobjekte erstellen, die für API-Aufrufe verwendet werden können. GoogleAdsClient bietet mehrere Möglichkeiten zur Konfiguration und Instanziierung:

  • google_ads_php.ini-Datei verwenden
  • Umgebungsvariablen festlegen
  • Setter-Methoden für GoogleAdsClientBuilder aufrufen

Weitere Informationen finden Sie im Konfigurationsleitfaden.

Wenn Sie ein GoogleAdsClient-Objekt mit expliziten Einstellungen konfigurieren möchten, erstellen Sie ein OAuth2TokenBuilder-Objekt und ein GoogleAdsClientBuilder-Objekt und rufen Sie die entsprechenden Setter-Methoden auf:

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->withClientId('INSERT_CLIENT_ID_HERE')
    ->withClientSecret('INSERT_CLIENT_SECRET_HERE')
    ->withRefreshToken('INSERT_REFRESH_TOKEN_HERE')
    ->build();

// Construct a Google Ads client configured from explicit settings and the
// OAuth 2.0 credentials.
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    // Replace 1234567890 with your login customer ID.
    ->withLoginCustomerId(1234567890)
    ->build();

Dienste erstellen

GoogleAdsClient bietet eine Getter-Methode für jedes Dienstclientobjekt. Wenn Sie beispielsweise eine Instanz von CampaignServiceClient erstellen möchten, rufen Sie die $googleAdsClient->getCampaignServiceClient() Methode auf, wie im vorherigen Beispiel gezeigt.

Fehlerbehandlung

Nicht jeder API-Aufruf ist erfolgreich. Der Server kann Fehler auslösen, wenn Ihre API-Aufrufe aus irgendeinem Grund fehlschlagen. Es ist wichtig, API-Fehler zu erfassen und entsprechend zu behandeln.

Bei einem API-Fehler wird eine GoogleAdsException-Instanz ausgelöst. Sie enthält Details, mit denen Sie die Ursache des Fehlers ermitteln können:

use Google\Ads\GoogleAds\Lib\V26\GoogleAdsException;
use Google\ApiCore\ApiException;

try {
    // Make your API call here.
} catch (GoogleAdsException $googleAdsException) {
    printf(
        "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
        $googleAdsException->getRequestId(),
        PHP_EOL,
        PHP_EOL
    );
    foreach (
        $googleAdsException->getGoogleAdsFailure()->getErrors() as $error
    ) {
        printf(
            "\t%s: %s%s",
            $error->getErrorCode()->getErrorCode(),
            $error->getMessage(),
            PHP_EOL
        );
    }
} catch (ApiException $apiException) {
    printf(
        "ApiException was thrown with message '%s'.%s",
        $apiException->getMessage(),
        PHP_EOL
    );
}