- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Muestra todas las filas que coinciden con la consulta de flujo de búsqueda.
Lista de errores arrojados: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError
Solicitud HTTP
POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:searchStream
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customer |
Obligatorio. El ID del cliente sobre el que se consulta. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"query": string,
"batchSize": integer,
"summaryRowSetting": enum ( |
Campos | |
---|---|
query |
Obligatorio. Es la cadena de consulta. |
batch |
Es la cantidad de filas que se devuelven en cada lote de respuesta de flujo. Cuando se solicita un lote muy grande, el servidor puede decidir limitar aún más la cantidad de filas devueltas. |
summary |
Determina si se mostrará una fila de resumen. De forma predeterminada, no se muestra la fila de resumen. Si se solicita, la fila de resumen se enviará en una respuesta por sí sola después de que se muestren todos los demás resultados de la consulta. |
Cuerpo de la respuesta
Mensaje de respuesta para SearchAds360Service.SearchStream
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "results": [ { object ( |
Campos | |
---|---|
results[] |
Es la lista de filas que coincidieron con la consulta. |
field |
FieldMask que representa qué campos solicitó el usuario. Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: |
summary |
Es la fila de resumen que contiene el resumen de las métricas en los resultados. Resumen de métricas significa la agregación de métricas en todos los resultados, aquí la agregación podría ser suma, promedio, tasa, etcétera. |
custom |
Los encabezados de las columnas personalizadas en los resultados. |
conversion |
Los encabezados de las métricas personalizadas de conversiones en los resultados |
conversion |
Los encabezados de la dimensión personalizada de conversión en los resultados |
raw |
Los encabezados de las métricas de conversión de eventos sin procesar en los resultados |
raw |
Los encabezados de las dimensiones de conversión de eventos sin procesar en los resultados |
request |
El ID único de la solicitud que se usa para depurar. |
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/doubleclicksearch