Para recuperar entidades e dados de relatórios da API Google Ads, use um destes métodos:
Estas são as principais distinções para os dois métodos:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Adequado para código de produção | Sim | Sim |
| Serviço | GoogleAdsService |
GoogleAdsService |
| Cenário | Buscando objetos e relatórios | Buscando objetos e relatórios |
| Resposta | Stream de objetos GoogleAdsRow |
Páginas de objetos GoogleAdsRow |
| Campos da resposta | Somente o que é especificado na consulta | Somente o que é especificado na consulta |
| Limites diários | Limites diários baseados nos níveis de acesso | Limites diários baseados nos níveis de acesso |
SearchStream x Pesquisa
Embora Search possa enviar várias solicitações paginadas para fazer o download do relatório inteiro, SearchStream envia uma única solicitação e inicia uma conexão permanente com a API Google Ads, independentemente do tamanho do relatório.
Para SearchStream, o download dos pacotes de dados é iniciado imediatamente com todo o resultado
armazenado em cache em um buffer de dados. O código pode começar a ler os dados armazenados em buffer
sem precisar esperar a conclusão de todo o stream.
Ao eliminar o tempo de ida e volta necessário para solicitar cada página
de uma resposta Search, dependendo do app, o SearchStream pode oferecer
melhor desempenho em relação à paginação, especialmente para relatórios maiores.
Exemplo
Considere um relatório que consiste em 100,000 linhas, por exemplo. A tabela a seguir detalha as diferenças de contabilização entre os dois métodos.
| SearchStream | Pesquisar | |
|---|---|---|
| Tamanho da página | Não aplicável | 10.000 linhas por página |
| Número de solicitações de API | 1 solicitação | 10 solicitações |
| Número de respostas da API | 1 stream contínuo | 10 respostas |
Fatores de desempenho
Para a maioria dos casos de uso, recomendamos SearchStream em vez de Search pelos seguintes
motivos:
Para relatórios de página única (menos de 10 mil linhas): não há diferenças de desempenho significativas entre os dois métodos.
Para relatórios de várias páginas: o
SearchStreamnormalmente é mais rápido, já que vários ciclos de ida e volta são evitados e a leitura ou gravação do cache de disco é menos um fator.
Limitações de taxa
Os limites diários dos dois métodos aderem aos limites padrão e aos níveis de acesso do token de desenvolvedor. Uma única consulta ou relatório é contado como uma operação, independentemente do resultado ser paginado ou transmitido.