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\u003eUses a GET request with path and query parameters to specify the customer and date.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides the completion status name and percentile.\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 categories indicate the completion range, from less than 95% to at least 99.9%.\u003c/p\u003e\n"]]],["This document details how to retrieve the import completion status of Google data into Ads Data Hub (ADH). A `GET` request is sent to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}/importCompletionStatus` with a required `customer` path parameter. Mandatory query parameters include `date` and `timeZone`. The request body must be empty. The response contains a `name` string and a `percentile` enum indicating the import completion percentage, categorized as \"less than 95%\", \"at least 95%\", \"at least 99%\", or \"at least 99.9%\". The OAuth scope `https://www.googleapis.com/auth/adsdatahub` is required.\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/marketers/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/marketers/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}_{utc_offset}' |\n| `percentile` | `enum (`[Percentile](/ads-data-hub/marketers/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\\]. |"]]
