Transporte

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

  • Preferencial (grpc): gRPC. Ele exige a instalação da extensão gRPC PHP e é baseado em HTTP/2.
  • Fallback (rest): REST. Usado automaticamente quando a extensão gRPC não está disponível. Não é necessário instalar extensões PHP adicionais, e ele é baseado 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 forma 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 configurar a definição de transporte de maneira programática ao construir o cliente:

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