This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
Returns the percentage of Google data across all customers that has successfully been ingested into ADH on the given date. The returned value is one of the buckets "less than 95%", "at least 95%", "at least 99%", and "at least 99.9%".
HTTP request
GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}/importCompletionStatus
Required. The date for which the completion status is to be returned. It must be in the past.
timeZone
string
Time zone used when determining the period to retrieve results for. Supported values are "America/Los_Angeles" and "America/New_York". Defaults to "America/Los_Angeles".
Request body
The request body must be empty.
Response body
Response to a customers.getImportCompletionStatus request.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eReturns the percentage of Google data successfully ingested into ADH for a specific date, categorized into percentile buckets.\u003c/p\u003e\n"],["\u003cp\u003eRequires an HTTP GET request with customer ID and date as path and query parameters respectively.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a completion status percentile and the name of the import completion status resource.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003ePercentile buckets represent the completion status: less than 95%, at least 95%, at least 99%, and at least 99.9%.\u003c/p\u003e\n"]]],["This content outlines how to retrieve the Google data import completion status for Ads Data Hub (ADH). It uses a `GET` request to the specified endpoint, including the customer ID in the path. Required query parameters are the `date` and optional `timeZone`. The request body is empty. The response returns the import status `name` and the data `percentile`, categorized as \"less than 95%\", \"at least 95%\", \"at least 99%\", or \"at least 99.9%,\" indicating the percentage of data ingested.\n"],null,["# Method: customers.getImportCompletionStatus\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ImportCompletionStatus.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Percentile](#Percentile)\n\nReturns the percentage of Google data across all customers that has successfully been ingested into ADH on the given date. The returned value is one of the buckets \"less than 95%\", \"at least 95%\", \"at least 99%\", and \"at least 99.9%\".\n\n### HTTP request\n\n`GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}/importCompletionStatus`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Ads Data Hub customer making the request. This is in the form of 'customers/\\[customerId\\]'. e.g. 'customers/123'. |\n\n### Query parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/ads-data-hub/reference/rest/v1/Date)`)` Required. The date for which the completion status is to be returned. It must be in the past. |\n| `timeZone` | `string` Time zone used when determining the period to retrieve results for. Supported values are \"America/Los_Angeles\" and \"America/New_York\". Defaults to \"America/Los_Angeles\". |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a customers.getImportCompletionStatus request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"percentile\": enum (/ads-data-hub/reference/rest/v1/customers/getImportCompletionStatus#Percentile) } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the import completion status resource in the format of 'customers/{id}/importStatus/{date}_{utcOffset}' |\n| `percentile` | `enum (`[Percentile](/ads-data-hub/reference/rest/v1/customers/getImportCompletionStatus#Percentile)`)` Percent of Google data being imported across all ADH customers for a given date that is complete. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`\n\nPercentile\n----------\n\nImport completion status categories representing a coarse percentile.\n\n| Enums ||\n|--------------------------|------------------------------------------------|\n| `PERCENTILE_UNSPECIFIED` | Completion status is unknown. |\n| `LESS_THAN_95_PERCENT` | Completion status percentile \\[0 .. 95.0). |\n| `AT_LEAST_95_PERCENT` | Completion status percentile \\[0.95 .. 0.99). |\n| `AT_LEAST_99_PERCENT` | Completion status percentile \\[0.99 .. 0.999). |\n| `AT_LEAST_99_9_PERCENT` | Completion status percentile \\[0.999 .. 1.0\\]. |"]]
