Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea una query. Quando la frequenza di pianificazione è ONE_TIME, anche la query creata viene eseguita automaticamente.
Prova subito.
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query
Parametri
Nome del parametro
Valore
Descrizione
Parametri di query facoltativi
asynchronous
boolean
Indica se la query deve essere eseguita in modo asincrono. Se impostato su true, questo metodo
ritornerà immediatamente. Se il valore è false o non viene specificato, questo metodo non
fino al termine dell'esecuzione della query. Applicabile solo se
la frequenza è ONE_TIME.
(Valore predefinito: false)
Autorizzazione
Questa richiesta richiede l'autorizzazione con il seguente ambito:
Nel corpo della richiesta, fornisci una risorsa Query.
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa Query nel corpo della risposta.
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.
In alternativa, prova la
autonomo
Spazio di esplorazione.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis version of the Bid Manager API is sunset, and users must migrate to Bid Manager API v2.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this version may return an error, and certain fields in retrieved \u003ccode\u003eQuery\u003c/code\u003e resources will be empty.\u003c/p\u003e\n"],["\u003cp\u003eCreating a query with a \u003ccode\u003eONE_TIME\u003c/code\u003e schedule frequency automatically runs the query.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope is required.\u003c/p\u003e\n"]]],[],null,["# Queries: createquery\n\n| This version of the Bid Manager API has been sunset. Users must [migrate to Bid Manager API v2](/bid-manager/how-tos/v2-migration).\n|\n|\n| Requests to this version may return an error. If the request is successful, the following fields in retrieved [`Query`](/bid-manager/v1.1/queries#resource) resources will be empty:\n|\n| - [`metadata.googleCloudStoragePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleCloudStoragePathForLatestReport)\n| - [`metadata.latestReportRunTimeMs`](/bid-manager/v1.1/queries#metadata.latestReportRunTimeMs)\n| - [`metadata.googleDrivePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleDrivePathForLatestReport)\n|\n| \u003cbr /\u003e\n|\n| **Note:** Requires [authorization](#auth).\n\nCreates a query. When the schedule frequency is `ONE_TIME`, the created query is also run automatically.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/query\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `asynchronous` | `boolean` | Whether the query should be run asynchronously. When true, this method will return immediately. When false or not specified, this method will not return until the query has finished running. Only applicable when the frequency is `ONE_TIME`. (Default: `false`) |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` |\n\nFor more information, see the [authentication and authorization](/bid-manager/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Queries resource](/bid-manager/v1.1/queries#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [Queries resource](/bid-manager/v1.1/queries#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclickbidmanager/v1.1/doubleclickbidmanager.queries.createquery)."]]
