Transporte

Há dois tipos de transporte que podem ser usados ao enviar solicitações para a API. A biblioteca de cliente do PHP seleciona automaticamente o transporte ideal com base no seu ambiente:

  • Preferencial (grpc): gRPC. Ele requer a instalação da extensão gRPC para PHP e é baseado em HTTP/2.
  • Substituto (rest): REST. Usado automaticamente quando a extensão gRPC não está disponível. Ela não requer a instalação de outras extensões PHP e é baseada em HTTP/1.1.

Configurar transporte

Se você preferir especificar explicitamente o tipo de transporte (grpc ou rest) em vez de usar as regras de seleção automática padrão descritas na seção anterior, configure a definição transport no arquivo google_ads_php.ini ou de maneira programática.

Configurar em google_ads_php.ini

Defina a propriedade transport na seção CONNECTION do arquivo google_ads_php.ini:

[CONNECTION]
; Optional transport settings.
; By default, "grpc" is used if available; otherwise, "rest" is used.
transport = "grpc"

Configurar de forma programática

Como alternativa, é possível definir a configuração de transporte de maneira programática ao criar o cliente:

$googleAdsClient = (new GoogleAdsClientBuilder())
    // ...
    ->withTransport('grpc')
    ->build();