Para extrair entidades e dados de relatórios da API Google Ads, use um destes métodos:
Confira as diferenças entre os dois métodos:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Adequado para código de produção | Sim | Sim |
| Serviço | GoogleAdsService |
GoogleAdsService |
| Cenário | Como buscar objetos e relatórios | Como buscar objetos e relatórios |
| Resposta | Fluxo de objetos GoogleAdsRow |
Páginas de objetos GoogleAdsRow |
| Campos da resposta | Somente os especificados na consulta | Somente os especificados na consulta |
| Limites diários | Limites diários com base nos níveis de acesso | Limites diários com base nos níveis de acesso |
SearchStream x Search
Embora a Search possa enviar várias
solicitações paginadas para fazer o download do relatório inteiro, a SearchStream envia uma única solicitação e
inicia uma conexão persistente com a API Google Ads, independentemente do tamanho do relatório.
No caso de SearchStream, os pacotes de dados começam a ser transferidos 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 o término de todo o stream.
Ao eliminar o tempo de ida e volta da rede necessário para solicitar cada página
individual de uma resposta Search, dependendo do app, SearchStream pode oferecer
melhor desempenho em relação à paginação, especialmente para relatórios maiores.
Exemplo
Este exemplo analisa um relatório que consiste em 100,000 linhas. A tabela a seguir
descreve as diferenças de contabilidade 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 uma página (menos de 10.000 linhas): não há diferenças significativas de desempenho entre os dois métodos.
Para relatórios de várias páginas:
SearchStreamgeralmente é mais rápido, já que várias viagens de ida e volta são evitadas, e a leitura ou gravação do cache do disco é menos um fator.
Limites de taxas
Os limites diários dos dois métodos aderem aos limites padrão e aos níveis de acesso do seu token de desenvolvedor. Uma única consulta ou relatório é contado como uma operação, independentemente do resultado ser paginado ou transmitido.