Uso básico

El uso básico de la biblioteca cliente es el siguiente:

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.

Crea una instancia de GoogleAdsClient

La clase más importante de la biblioteca de PHP de la API de Google Ads es la clase GoogleAdsClient. Te permite crear objetos cliente de servicio preconfigurados que se pueden usar para realizar llamadas a la API. GoogleAdsClient proporciona varias formas de crear instancias:

  • Usa un archivo google_ads_php.ini.
  • Usa variables de entorno.
  • Usa métodos set en GoogleAdsClientBuilder.

Consulta la guía de configuración para obtener más información.

Para configurar un objeto GoogleAdsClient, crea un OAuth2TokenBuilderobjeto y un GoogleAdsClientBuilder objeto, y establece la configuración necesaria:

// 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();

Crear un servicio

GoogleAdsClient proporciona un método getter para cada objeto cliente de servicio. Por ejemplo, para crear una instancia de CampaignServiceClient, llama al método GoogleAdsClient->getCampaignServiceClient() como se muestra en el ejemplo anterior.

Manejo de errores

No todas las llamadas a la API se realizarán correctamente. El servidor puede arrojar errores si las llamadas a la API fallan por algún motivo. Es importante capturar los errores de la API y manejarlos de forma adecuada.

Se arroja una instancia de GoogleAdsException cuando se produce un error de la API. Tiene detalles que te ayudarán a descubrir qué falló:

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
    );
}