curl --request GET \
--url https://api.hubapi.com/crm/v3/imports/{importId}/errors \
--header 'Authorization: Bearer <token>'{
"results": [
{
"createdAt": 123,
"errorType": "AMBIGUOUS_ENUMERATION_OPTION",
"id": "<string>",
"sourceData": {
"containsEncryptedProperties": true,
"fileId": 123,
"lineNumber": 123,
"rowData": [
"<string>"
],
"pageName": "<string>"
},
"errorMessage": "<string>",
"extraContext": "<string>",
"invalidPropertyValue": {
"dataSensitivity": "high",
"isEncrypted": true,
"isLargeValue": true,
"name": "<string>",
"persistenceTimestamp": 123,
"requestId": "<string>",
"selectedByUser": true,
"selectedByUserTimestamp": 123,
"source": "ACADEMY",
"sourceId": "<string>",
"sourceLabel": "<string>",
"sourceMetadata": "<string>",
"sourceVid": [
123
],
"timestamp": 123,
"unit": "<string>",
"updatedByUserId": 123,
"useTimestampAsPersistenceTimestamp": true,
"value": "<string>"
},
"invalidValue": "<string>",
"invalidValueToDisplay": "<string>",
"knownColumnNumber": 123,
"objectType": "ABANDONED_CART",
"objectTypeId": "<string>"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}特定のインポート処理の詳しいエラーレコードを取得し、処理中に失敗したレコードを特定してトラブルシューティングできるようにします。
curl --request GET \
--url https://api.hubapi.com/crm/v3/imports/{importId}/errors \
--header 'Authorization: Bearer <token>'{
"results": [
{
"createdAt": 123,
"errorType": "AMBIGUOUS_ENUMERATION_OPTION",
"id": "<string>",
"sourceData": {
"containsEncryptedProperties": true,
"fileId": 123,
"lineNumber": 123,
"rowData": [
"<string>"
],
"pageName": "<string>"
},
"errorMessage": "<string>",
"extraContext": "<string>",
"invalidPropertyValue": {
"dataSensitivity": "high",
"isEncrypted": true,
"isLargeValue": true,
"name": "<string>",
"persistenceTimestamp": 123,
"requestId": "<string>",
"selectedByUser": true,
"selectedByUserTimestamp": 123,
"source": "ACADEMY",
"sourceId": "<string>",
"sourceLabel": "<string>",
"sourceMetadata": "<string>",
"sourceVid": [
123
],
"timestamp": 123,
"unit": "<string>",
"updatedByUserId": 123,
"useTimestampAsPersistenceTimestamp": true,
"value": "<string>"
},
"invalidValue": "<string>",
"invalidValueToDisplay": "<string>",
"knownColumnNumber": 123,
"objectType": "ABANDONED_CART",
"objectTypeId": "<string>"
}
],
"paging": {
"next": {
"after": "<string>",
"link": "<string>"
}
}
}サポートされる製品
必須スコープ
crm.importThe access token received from the authorization server in the OAuth 2.0 flow.
インポートの固有ID。
最後に正常に読み取られたリソースのページ操作カーソルトークンは、より多くの結果を含むページ付きレスポンスのpaging.next.after JSONプロパティーとして返されます。
エラーについて説明するメッセージを受信するにはTrueに設定します。
エラーがある行のデータ値を受信するにはTrueに設定します。
ページごとに表示する結果の最大数。
successful operation
Anzeigen untergeordnete attribute
エラーが記録された時点のエポックミリ秒のタイムスタンプ。
インポート処理中に発生した問題の分類。
AMBIGUOUS_ENUMERATION_OPTION, ASSOCIATION_LABEL_NOT_FOUND, ASSOCIATION_LIMIT_EXCEEDED, ASSOCIATION_RECORD_NOT_FOUND, COLUMN_TOO_LARGE, COULD_NOT_FIND_BUSINESS_UNIT, COULD_NOT_FIND_OWNER, COULD_NOT_PARSE_DATE, COULD_NOT_PARSE_NUMBER, COULD_NOT_PARSE_ROW, COULD_NOT_PARSE_TERM, CREATE_ONLY_IMPORT, DUPLICATE_ALTERNATE_ID, DUPLICATE_ASSOCIATION_ID, DUPLICATE_EVENT, DUPLICATE_OBJECT_ID, DUPLICATE_RECORD_ID, DUPLICATE_ROW_CONTENT, DUPLICATE_UNIQUE_PROPERTY_VALUE, FAILED_TO_CREATE_ASSOCIATION, FAILED_TO_OPT_OUT_CONTACT, FAILED_TO_PROCESS_OBJECT_WITH_EMPTY_PROPERTY_VALUES, FAILED_VALIDATION, FILE_NOT_FOUND, GDPR_BLACKLISTED_EMAIL, INCORRECT_NUMBER_OF_COLUMNS, INVALID_ALTERNATE_ID, INVALID_ASSOCIATION_IDENTIFIER, INVALID_ASSOCIATION_KEY, INVALID_COLUMN_CONFIGURATION, INVALID_CUSTOM_PROPERTY_VALIDATION, INVALID_DOMAIN, INVALID_EMAIL, INVALID_ENUMERATION_OPTION, INVALID_EVENT, INVALID_EVENT_TIMESTAMP, INVALID_FILE_TYPE, INVALID_NUMBER_SIZE, INVALID_OBJECT_ID, INVALID_RECORD_ID, INVALID_REQUIRED_PROPERTY, INVALID_SHEET_COUNT, INVALID_SPREADSHEET, LIMIT_EXCEEDED, MANY_ERRORS_IN_ROW, MISSING_EVENT_DEFINITION, MISSING_EVENT_TIMESTAMP, MISSING_OBJECT_DEFINITION, MISSING_REQUIRED_PROPERTY, MULTIPLE_COMPANIES_WITH_THIS_DOMAIN, MULTIPLE_OWNERS_FOUND, NO_OBJECT_ID_FROM_ASSOCIATION_IDENTIFIER, OUTSIDE_VALID_TERM_RANGE, OUTSIDE_VALID_TIME_RANGE, PORTAL_WIDE_CUSTOM_OBJECT_LIMIT_EXCEEDED, PROPERTY_DEFINITION_NOT_FOUND, PROPERTY_VALUE_NOT_FOUND, ROW_DATA_TOO_LARGE, SECONDARY_EMAIL_WRITE_FAILURE, UNKNOWN_ASSOCIATION_RECORD_ID, UNKNOWN_BAD_REQUEST, UNKNOWN_ERROR, UPDATE_ONLY_IMPORT この特定のエラーの固有の安定したID。
Anzeigen untergeordnete attribute
この行に暗号化された値が含まれるかどうかを示します。
この行が含まれるアップロードされたファイルの固有ID。
ソースファイル内におけるこの行の1から始まる行番号。行番号0は特定の行に対応しないファイル全体のエラーのために予約されています。
この行が含まれるスプレッドシートのシート/ページの名前。
人間が読めるエラーメッセージ。
エラーに関する人間が読める追加のコンテキスト。
Represents a single custom property of a marketing event, storing its name, value, metadata (like source, timestamp, and sensitivity), and related audit information for tracking changes.
Anzeigen untergeordnete attribute
The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".
high, none, standard Whether the property value is encrypted.
値が通常のサイズの上限を超えるかどうかを示します。
The unique property name.
値がデータベースに保存された時点(エポックミリ秒)。
A unique ID associated with this request.
Whether the value was selected by a user.
The timestamp when the value was selected by a user, if applicable.
The origin of the property value, such as "IMPORT" or "API".
ACADEMY, ACCEPTANCE_TEST, ADS, AI_GROUP, ANALYTICS, API, APPROVALS, ASSISTS, ASSOCIATIONS, AUTOMATION_JOURNEY, AUTOMATION_PLATFORM, AVATARS_SERVICE, BATCH_UPDATE, BCC_TO_CRM, BEHAVIORAL_EVENTS, BET_ASSIGNMENT, BET_CRM_CONNECTOR, BIDEN, BILLING, BOT, CALCULATED, CHATSPOT, COMMUNICATOR, COMPANIES, COMPANY_FAMILIES, COMPANY_INSIGHTS, CONTACTS, CONTACTS_WEB, CONTENT_MEMBERSHIP, CONVERSATIONS, CRM_UI, CRM_UI_BULK_ACTION, DATA_ENRICHMENT, DEALS, DEFAULT, EMAIL, EMAIL_INTEGRATION, ENGAGEMENTS, EXTENSION, FILE_MANAGER, FLYWHEEL_PRODUCT_DATA_SYNC, FORECASTING, FORM, FORWARD_TO_CRM, GMAIL_INTEGRATION, GOALS, HEISENBERG, HELP_DESK, IMPORT, INTEGRATION, INTEGRATIONS_PLATFORM, INTEGRATIONS_SYNC, INTENT, INTERNAL_PROCESSING, LEADIN, MARKETPLACE, MEETINGS, MERGE_COMPANIES, MERGE_CONTACTS, MERGE_OBJECTS, MICROAPPS, MIGRATION, MOBILE_ANDROID, MOBILE_IOS, PAYMENTS, PIPELINE_SETTINGS, PLAYBOOKS, PORTAL_OBJECT_SYNC, PORTAL_USER_ASSOCIATOR, PRESENTATIONS, PROPERTY_SETTINGS, PROSPECTING_AGENT, QUOTAS, QUOTES, RECYCLING_BIN, SALES, SALES_MESSAGES, SALESFORCE, SEQUENCES, SETTINGS, SIDEKICK, SIGNALS, SLACK_INTEGRATION, SOCIAL, SUCCESS, TALLY, TASK, UNKNOWN, WAL_INCREMENTAL, WORKFLOW_CONTACT_DELETE_ACTION, WORKFLOWS The ID of the property source indicating where it was created.
A human-readable label.
Metadata providing additional context about the source.
The unique identifier associated with the source.
When the value was set, as a 64-bit integer.
The unit of measurement or context for the value.
The ID of the user who updated the property.
タイムスタンプフィールドを保存タイムスタンプとして使用するかどうかを示すフラグ。
The property value.
検証失敗の原因となったインポートファイルからの素のままの文字列値。
「invalidPropertyValue」または「invalidValue」のいずれか存在する方(プロパティー値が優先)からの値を返す利便性アクセサー。
エラーが発生したインポートファイルにおける0から始まる列インデックス
このエラーの影響を受けたCRMオブジェクトタイプ。
ABANDONED_CART, ACCEPTANCE_TEST, AD, AD_ACCOUNT, AD_CAMPAIGN, AD_GROUP, AI_FORECAST, ALL_PAGES, APPROVAL, APPROVAL_STEP, ATTRIBUTION, AUDIENCE, AUTOMATION_JOURNEY, AUTOMATION_PLATFORM_FLOW, AUTOMATION_PLATFORM_FLOW_ACTION, BET_ALERT, BET_DELIVERABLE_SERVICE, BLOG_LISTING_PAGE, BLOG_POST, CALL, CAMPAIGN, CAMPAIGN_BUDGET_ITEM, CAMPAIGN_SPEND_ITEM, CAMPAIGN_STEP, CAMPAIGN_TEMPLATE, CAMPAIGN_TEMPLATE_STEP, CART, CASE_STUDY, CHATFLOW, CLIP, CMS_URL, COMBO_EVENT_CONFIGURATION, COMMERCE_PAYMENT, COMMUNICATION, COMPANY, CONTACT, CONTACT_CREATE_ATTRIBUTION, CONTENT, CONTENT_AUDIT, CONTENT_AUDIT_PAGE, CONVERSATION, CONVERSATION_INBOX, CONVERSATION_SESSION, CRM_OBJECTS_DUMMY_TYPE, CRM_PIPELINES_DUMMY_TYPE, CTA, CTA_VARIANT, DATA_PRIVACY_CONSENT, DATA_SYNC_STATE, DEAL, DEAL_CREATE_ATTRIBUTION, DEAL_REGISTRATION, DEAL_SPLIT, DISCOUNT, DISCOUNT_CODE, DISCOUNT_TEMPLATE, EMAIL, ENGAGEMENT, EXPORT, EXTERNAL_WEB_URL, FEE, FEEDBACK_SUBMISSION, FEEDBACK_SURVEY, FILE_MANAGER_FILE, FILE_MANAGER_FOLDER, FOLDER, FORECAST, FORM, FORM_SUBMISSION_INBOUNDDB, GOAL_TARGET, GOAL_TARGET_GROUP, GOAL_TEMPLATE, GSC_PROPERTY, HUB, IMPORT, INVOICE, KEYWORD, KNOWLEDGE_ARTICLE, LANDING_PAGE, LEAD, LINE_ITEM, MARKETING_CALENDAR, MARKETING_CAMPAIGN_UTM, MARKETING_EMAIL, MARKETING_EVENT, MARKETING_EVENT_ATTENDANCE, MARKETING_SMS, MEDIA_BRIDGE, MEETING_EVENT, MIC, NOTE, OBJECT_LIST, ORDER, OWNER, PARTNER_ACCOUNT, PARTNER_CLIENT, PARTNER_CLIENT_REVENUE, PARTNER_SERVICE, PAYMENT_LINK, PAYMENT_SCHEDULE, PAYMENT_SCHEDULE_INSTALLMENT, PERMISSIONS_TESTING, PLAYBOOK, PLAYBOOK_QUESTION, PLAYBOOK_SUBMISSION, PLAYBOOK_SUBMISSION_ANSWER, PLAYLIST, PLAYLIST_FOLDER, PODCAST_EPISODE, PORTAL, PORTAL_OBJECT_SYNC_MESSAGE, POSTAL_MAIL, PRIVACY_SCANNER_COOKIE, PRODUCT, PRODUCT_OR_FOLDER, PROPERTY_INFO, PROSPECTING_AGENT_CONTACT_ASSIGNMENT, PUBLISHING_TASK, QUARANTINED_SUBMISSION, QUOTA, QUOTE, QUOTE_FIELD, QUOTE_MODULE, QUOTE_MODULE_FIELD, QUOTE_TEMPLATE, RESTORABLE_CRM_OBJECT, ROSTER, ROSTER_MEMBER, SALES_DOCUMENT, SALES_TASK, SALES_WORKLOAD, SALESFORCE_SYNC_ERROR, SCHEDULING_PAGE, SCHEMAS_BACKEND_TEST, SCORE_CONFIGURATION, SEQUENCE, SEQUENCE_ENROLLMENT, SEQUENCE_STEP, SEQUENCE_STEP_ENROLLMENT, SERVICE, SITE_PAGE, SNIPPET, SOCIAL_BROADCAST, SOCIAL_CHANNEL, SOCIAL_POST, SOCIAL_PROFILE, SOX_PROTECTED_DUMMY_TYPE, SOX_PROTECTED_TEST_TYPE, SUBMISSION_TAG, SUBSCRIPTION, TASK, TASK_TEMPLATE, TAX, TEMPLATE, TICKET, UNKNOWN, UNSUBSCRIBE, USER, VIEW, VIEW_BLOCK, WEB_INTERACTIVE このエラーの影響を受けたCRMオブジェクトのモダンなオブジェクトタイプID。
Anzeigen untergeordnete attribute
Specifies the paging information needed to retrieve the next set of results in a paginated API response