Grundlegende Nutzung

Die grundlegende Verwendung der Clientbibliothek sieht so aus:

use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V25\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\ApiCore\ApiException;

// 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
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

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

// Make calls to CampaignServiceClient.

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 verschiedene Möglichkeiten zur Instanziierung:

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

Weitere Informationen finden Sie im Konfigurationsleitfaden.

Wenn Sie ein GoogleAdsClient-Objekt konfigurieren möchten, erstellen Sie ein OAuth2TokenBuilder-Objekt und ein GoogleAdsClientBuilder -Objekt und legen Sie die erforderlichen Einstellungen fest:

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

// Construct a Google Ads client configured from a properties file
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->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, die Ihnen helfen, die Ursache des Fehlers zu ermitteln:

use Google\Ads\GoogleAds\Lib\V25\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
    );
}