--- title: "POST /v23/customers/{+customerId}:mutate" method: POST path: "/v23/customers/{+customerId}:mutate" tags: ["customers"] --- # POST /v23/customers/{+customerId}:mutate `POST /v23/customers/{+customerId}:mutate` Updates a customer. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [FieldMaskError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]() [UrlFieldError]() ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesMutateCustomerRequest — Request message for CustomerService.MutateCustomer. - `responseContentType` 'UNSPECIFIED' | 'RESOURCE_NAME_ONLY' | 'MUTABLE_RESOURCE' — The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation. - `operation` GoogleAdsSearchads360V23ServicesCustomerOperation — A single update on a customer. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `update` GoogleAdsSearchads360V23ResourcesCustomer — A customer. - `associateManagerDescriptiveName` string — Output only. The descriptive name of the associate manager. - `accountStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'SUSPENDED' | 'REMOVED' | 'DRAFT' — Output only. Account status, for example, Enabled, Paused, Removed, etc. - `engineId` string — Output only. ID of the account in the external engine account. - `optimizationScoreWeight` number, double — Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of `Customer.optimization_score * Customer.optimization_score_weight`. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only. - `accountLevel` 'UNSPECIFIED' | 'UNKNOWN' | 'CLIENT_ACCOUNT_FACEBOOK' | 'CLIENT_ACCOUNT_GOOGLE_ADS' | 'CLIENT_ACCOUNT_MICROSOFT' | 'CLIENT_ACCOUNT_YAHOO_JAPAN' | 'CLIENT_ACCOUNT_ENGINE_TRACK' | 'MANAGER' | 'SUB_MANAGER' | 'ASSOCIATE_MANAGER' — Output only. The account level of the customer: Manager, Sub-manager, Associate manager, Service account. - `imageAssetAutoMigrationDoneDateTime` string — Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. - `hasPartnersBadge` boolean — Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774. - `doubleClickCampaignManagerSetting` GoogleAdsSearchads360V23ResourcesDoubleClickCampaignManagerSetting — DoubleClick Campaign Manager (DCM) setting for a manager customer. - `advertiserId` string, int64 — Output only. ID of the Campaign Manager advertiser associated with this customer. - `networkId` string, int64 — Output only. ID of the Campaign Manager network associated with this customer. - `timeZone` string — Output only. Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York. - `finalUrlSuffix` string — The URL template for appending params to the final URL. - `manager` boolean — Output only. Whether the customer is a manager. - `locationAssetAutoMigrationDoneDateTime` string — Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. - `callReportingSetting` GoogleAdsSearchads360V23ResourcesCallReportingSetting — Call reporting setting for a customer. - `callReportingEnabled` boolean — Enable reporting of phone call events by redirecting them through Google System. - `callConversionReportingEnabled` boolean — Whether to enable call conversion reporting. - `callConversionAction` string — Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true. - `videoBrandSafetySuitability` 'UNSPECIFIED' | 'UNKNOWN' | 'EXPANDED_INVENTORY' | 'STANDARD_INVENTORY' | 'LIMITED_INVENTORY' — Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. - `optimizationScore` number, double — Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only. - `descriptiveName` string — Optional, non-unique descriptive name of the customer. - `remarketingSetting` GoogleAdsSearchads360V23ResourcesRemarketingSetting — Remarketing setting for a customer. - `googleGlobalSiteTag` string — Output only. The Google tag. - `subManagerId` string, int64 — Output only. The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager. - `lastModifiedTime` string — Output only. The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `containsEuPoliticalAdvertising` 'UNSPECIFIED' | 'UNKNOWN' | 'CONTAINS_EU_POLITICAL_ADVERTISING' | 'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING' — Output only. Returns the advertiser self-declaration status of whether this customer contains political advertising content targeted towards the European Union. You can use the Google Ads UI to update this account-level declaration, or use the API to update the self-declaration status of individual campaigns. - `accountType` 'UNSPECIFIED' | 'UNKNOWN' | 'BAIDU' | 'ENGINE_TRACK' | 'FACEBOOK' | 'FACEBOOK_GATEWAY' | 'GOOGLE_ADS' | 'MICROSOFT' | 'SEARCH_ADS_360' | 'YAHOO_JAPAN' — Output only. Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc. - `id` string, int64 — Output only. The ID of the customer. - `payPerConversionEligibilityFailureReasons` string[] — Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only. - `imageAssetAutoMigrationDone` boolean — Output only. True if feed based image has been migrated to asset based image. - `managerDescriptiveName` string — Output only. The descriptive name of the manager. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL out of parameters. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'CANCELED' | 'SUSPENDED' | 'CLOSED' — Output only. The status of the customer. - `autoTaggingEnabled` boolean — Whether auto-tagging is enabled for the customer. - `conversionTrackingSetting` GoogleAdsSearchads360V23ResourcesConversionTrackingSetting — A collection of customer-wide settings related to Search Ads 360 Conversion Tracking. - `googleAdsCrossAccountConversionTrackingId` string, int64 — Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only. - `conversionTrackingId` string, int64 — Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only. - `googleAdsConversionCustomer` string — The resource name of the customer where conversions are created and managed. This field is read-only. - `conversionTrackingStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'NOT_CONVERSION_TRACKED' | 'CONVERSION_TRACKING_MANAGED_BY_SELF' | 'CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER' | 'CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER' — Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the `login-customer-id` of the request. - `crossAccountConversionTrackingId` string, int64 — Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id. - `acceptedCustomerDataTerms` boolean — Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709. - `enhancedConversionsForLeadsEnabled` boolean — Output only. Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. - `locationAssetAutoMigrationDone` boolean — Output only. True if feed based location has been migrated to asset based location. - `managerId` string, int64 — Output only. The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager. - `timeZone` string — Immutable. The local timezone ID of the customer. - `customerAgreementSetting` GoogleAdsSearchads360V23ResourcesCustomerAgreementSetting — Customer Agreement Setting for a customer. - `acceptedLeadFormTerms` boolean — Output only. Whether the customer has accepted lead form term of service. - `currencyCode` string — Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. - `videoCustomer` GoogleAdsSearchads360V23ResourcesVideoCustomer — Video specific information about a Customer. - `thirdPartyIntegrationPartners` GoogleAdsSearchads360V23CommonCustomerThirdPartyIntegrationPartners — Container for Customer level third party integration partners. - `viewabilityIntegrationPartners` GoogleAdsSearchads360V23CommonCustomerThirdPartyViewabilityIntegrationPartner[] — Allowed third party integration partners for YouTube viewability verification. - `viewabilityIntegrationPartner` 'UNSPECIFIED' | 'UNKNOWN' | 'DOUBLE_VERIFY' | 'INTEGRAL_AD_SCIENCE' — Allowed third party integration partners for YouTube viewability verification. - `allowShareCost` boolean — If true, cost data can be shared with this vendor. - `reachIntegrationPartners` GoogleAdsSearchads360V23CommonCustomerThirdPartyReachIntegrationPartner[] — Allowed third party integration partners for reach verification. - `reachIntegrationPartner` 'UNSPECIFIED' | 'UNKNOWN' | 'NIELSEN' | 'COMSCORE' | 'KANTAR_MILLWARD_BROWN' | 'VIDEO_RESEARCH' | 'GEMIUS' | 'MEDIA_SCOPE' | 'AUDIENCE_PROJECT' | 'VIDEO_AMP' | 'ISPOT_TV' — Allowed Third Party integration partners for reach verification. - `allowShareCost` boolean — If true, cost data can be shared with this vendor. - `brandSafetyIntegrationPartners` GoogleAdsSearchads360V23CommonCustomerThirdPartyBrandSafetyIntegrationPartner[] — Allowed third party integration partners for brand safety verification. - `brandSafetyIntegrationPartner` 'UNSPECIFIED' | 'UNKNOWN' | 'DOUBLE_VERIFY' | 'INTEGRAL_AD_SCIENCE' | 'ZEFR' — Allowed third party integration partners for brand safety verification. - `brandLiftIntegrationPartners` GoogleAdsSearchads360V23CommonCustomerThirdPartyBrandLiftIntegrationPartner[] — Allowed third party integration partners for Brand Lift verification. - `allowShareCost` boolean — If true, cost data can be shared with this vendor. - `brandLiftIntegrationPartner` 'UNSPECIFIED' | 'UNKNOWN' | 'KANTAR_MILLWARD_BROWN' | 'DYNATA' | 'INTAGE' | 'MACROMILL' — Allowed Third Party integration partners for Brand Lift verification. - `testAccount` boolean — Output only. Whether the customer is a test account. - `resourceName` string — Immutable. The resource name of the customer. Customer resource names have the form: `customers/{customer_id}` - `subManagerDescriptiveName` string — Output only. The descriptive name of the sub manager. - `localServicesSettings` GoogleAdsSearchads360V23ResourcesLocalServicesSettings — Settings for Local Services customer. - `granularLicenseStatuses` GoogleAdsSearchads360V23ResourcesGranularLicenseStatus[] — Output only. A read-only list of geo vertical level license statuses. - `verificationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'NEEDS_REVIEW' | 'FAILED' | 'PASSED' | 'NOT_APPLICABLE' | 'NO_SUBMISSION' | 'PARTIAL_SUBMISSION' | 'PENDING_ESCALATION' — Output only. Granular license status, per geo + vertical. - `geoCriterionId` string, int64 — Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information. - `categoryId` string — Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids - `granularInsuranceStatuses` GoogleAdsSearchads360V23ResourcesGranularInsuranceStatus[] — Output only. A read-only list of geo vertical level insurance statuses. - `geoCriterionId` string, int64 — Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information. - `categoryId` string — Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids - `verificationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'NEEDS_REVIEW' | 'FAILED' | 'PASSED' | 'NOT_APPLICABLE' | 'NO_SUBMISSION' | 'PARTIAL_SUBMISSION' | 'PENDING_ESCALATION' — Output only. Granular insurance status, per geo + vertical. - `associateManagerId` string, int64 — Output only. The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager. - `creationTime` string — Output only. The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)