Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem Giới thiệu về REST để biết chi tiết.

Trang này được dịch bởi Cloud Translation API.

Customer

Biểu diễn dưới dạng JSON
CallReportingSetting
- Biểu diễn dưới dạng JSON
ConversionTrackingSetting
- Biểu diễn dưới dạng JSON
ConversionTrackingStatus
RemarketingSetting
- Biểu diễn dưới dạng JSON
CustomerPayPerConversionEligibilityFailureReason
CustomerAgreementSetting
- Biểu diễn dưới dạng JSON
LocalServicesSettings (Cài đặt dịch vụ địa phương)
- Biểu diễn dưới dạng JSON
GranularLicenseStatus
- Biểu diễn dưới dạng JSON
LocalServicesVerificationStatus
GranularInsuranceStatus
- Biểu diễn dưới dạng JSON

Khách hàng.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "resourceName": string, "callReportingSetting": { object (`CallReportingSetting`) }, "conversionTrackingSetting": { object (`ConversionTrackingSetting`) }, "remarketingSetting": { object (`RemarketingSetting`) }, "payPerConversionEligibilityFailureReasons": [ enum (`CustomerPayPerConversionEligibilityFailureReason`) ], "optimizationScoreWeight": number, "status": enum (`CustomerStatus`), "customerAgreementSetting": { object (`CustomerAgreementSetting`) }, "localServicesSettings": { object (`LocalServicesSettings`) }, "id": string, "descriptiveName": string, "currencyCode": string, "timeZone": string, "trackingUrlTemplate": string, "finalUrlSuffix": string, "autoTaggingEnabled": boolean, "hasPartnersBadge": boolean, "manager": boolean, "testAccount": boolean, "optimizationScore": number, "locationAssetAutoMigrationDone": boolean, "imageAssetAutoMigrationDone": boolean, "locationAssetAutoMigrationDoneDateTime": string, "imageAssetAutoMigrationDoneDateTime": string }

{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "localServicesSettings": {
    object (LocalServicesSettings)
  },
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}

Các trường
`resourceName`	`string` Không thể thay đổi. Tên tài nguyên của khách hàng. Tên tài nguyên của khách hàng có dạng: `customers/{customerId}`
`callReportingSetting`	`object (CallReportingSetting)` Chế độ cài đặt báo cáo cuộc gọi cho một khách hàng. Chỉ có thể thay đổi trong thao tác `update`.
`conversionTrackingSetting`	`object (ConversionTrackingSetting)` Chỉ có đầu ra. Chế độ theo dõi lượt chuyển đổi cho một khách hàng.
`remarketingSetting`	`object (RemarketingSetting)` Chỉ có đầu ra. Cài đặt tái tiếp thị cho khách hàng.
`payPerConversionEligibilityFailureReasons[]`	`enum (CustomerPayPerConversionEligibilityFailureReason)` Chỉ có đầu ra. Lý do khiến khách hàng không đủ điều kiện sử dụng PaymentMode.Migration. Nếu danh sách này trống thì khách hàng đủ điều kiện. Trường này chỉ để đọc.
`optimizationScoreWeight`	`number` Chỉ có đầu ra. Trọng số của điểm tối ưu hoá của khách hàng. Bạn có thể sử dụng trọng số của điểm tối ưu hoá để so sánh/tổng hợp điểm tối ưu hoá của nhiều khách hàng không phải người quản lý. Điểm tối ưu hoá tổng hợp của một người quản lý được tính bằng tổng điểm của tất cả các khách hàng sử dụng `Customer.optimization_score * Customer.optimization_score_weight`. Trường này có giá trị là 0 đối với tất cả khách hàng là người quản lý và đối với khách hàng không phải người quản lý nhưng chưa được chấm điểm. Trường này chỉ để đọc.
`status`	`enum (CustomerStatus)` Chỉ có đầu ra. Trạng thái của khách hàng.
`customerAgreementSetting`	`object (CustomerAgreementSetting)` Chỉ có đầu ra. Cài đặt Thỏa thuận khách hàng cho một khách hàng.
`localServicesSettings`	`object (LocalServicesSettings)` Chỉ có đầu ra. Chế độ cài đặt cho khách hàng Dịch vụ địa phương.
`id`	`string (int64 format)` Chỉ có đầu ra. Mã nhận dạng của khách hàng.
`descriptiveName`	`string` Tên mô tả không bắt buộc, không phải duy nhất của khách hàng.
`currencyCode`	`string` Không thể thay đổi. Đơn vị tiền tệ mà tài khoản hoạt động. Một số mã đơn vị tiền tệ từ tiêu chuẩn ISO 4217 được hỗ trợ.
`timeZone`	`string` Không thể thay đổi. Mã múi giờ địa phương của khách hàng.
`trackingUrlTemplate`	`string` Mẫu URL để tạo URL theo dõi từ các tham số. Chỉ có thể thay đổi trong thao tác `update`.
`finalUrlSuffix`	`string` Mẫu URL để thêm các tham số vào URL cuối cùng. Chỉ có thể thay đổi trong thao tác `update`.
`autoTaggingEnabled`	`boolean` Liệu tính năng tự động gắn thẻ có được bật cho khách hàng hay không.
`hasPartnersBadge`	`boolean` Chỉ có đầu ra. Liệu Khách hàng có huy hiệu Chương trình Partners hay không. Nếu Khách hàng chưa liên kết với chương trình Partners, thì giá trị này sẽ là sai. Để biết thêm thông tin, hãy xem https://support.google.com/partners/answer/3125774.
`manager`	`boolean` Chỉ có đầu ra. Liệu khách hàng có phải là người quản lý hay không.
`testAccount`	`boolean` Chỉ có đầu ra. Liệu khách hàng có phải là tài khoản thử nghiệm hay không.
`optimizationScore`	`number` Chỉ có đầu ra. Điểm tối ưu hoá của khách hàng. Điểm tối ưu hoá là điểm số ước tính về mức độ hiệu quả của hoạt động thiết lập cho các chiến dịch của khách hàng. Nó dao động từ 0% (0,0) đến 100% (1,0). Trường này rỗng đối với tất cả khách hàng là người quản lý và đối với khách hàng không phải người quản lý nhưng không có điểm. Xem bài viết "Giới thiệu về điểm tối ưu hoá" tại https://support.google.com/google-ads/answer/9061546. Trường này chỉ để đọc.
`locationAssetAutoMigrationDone`	`boolean` Chỉ có đầu ra. Đúng nếu vị trí dựa trên nguồn cấp dữ liệu đã được di chuyển sang vị trí dựa trên thành phần.
`imageAssetAutoMigrationDone`	`boolean` Chỉ có đầu ra. Đúng nếu hình ảnh dựa trên nguồn cấp dữ liệu đã được chuyển sang hình ảnh dựa trên thành phần.
`locationAssetAutoMigrationDoneDateTime`	`string` Chỉ có đầu ra. Dấu thời gian của quá trình di chuyển từ vị trí dựa trên nguồn cấp dữ liệu sang vị trí cơ sở của tài sản ở định dạng yyyy-MM-dd HH:mm:ss.
`imageAssetAutoMigrationDoneDateTime`	`string` Chỉ có đầu ra. Dấu thời gian của quá trình di chuyển từ hình ảnh dựa trên nguồn cấp dữ liệu sang hình ảnh gốc của thành phần ở định dạng yyyy-MM-dd HH:mm:ss.

CallReportingSetting

Chế độ cài đặt báo cáo cuộc gọi cho một khách hàng. Chỉ có thể thay đổi trong thao tác update.

Biểu diễn dưới dạng JSON
{ "callReportingEnabled": boolean, "callConversionReportingEnabled": boolean, "callConversionAction": string }

Các trường

Các trường
`callReportingEnabled`	`boolean` Cho phép báo cáo các sự kiện cuộc gọi điện thoại bằng cách chuyển hướng các sự kiện đó qua Hệ thống Google.
`callConversionReportingEnabled`	`boolean` Liệu có bật báo cáo lượt chuyển đổi cuộc gọi hay không.
`callConversionAction`	`string` Hành động chuyển đổi liên quan đến cuộc gọi ở cấp khách hàng để phân bổ lượt chuyển đổi liên quan đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng một hành động chuyển đổi mặc định. Chỉ có hiệu lực khi đặt lệnh callconversionReportingEnabled thành true.

callReportingEnabled

boolean

Cho phép báo cáo các sự kiện cuộc gọi điện thoại bằng cách chuyển hướng các sự kiện đó qua Hệ thống Google.

callConversionReportingEnabled

boolean

Liệu có bật báo cáo lượt chuyển đổi cuộc gọi hay không.

callConversionAction

string

Hành động chuyển đổi liên quan đến cuộc gọi ở cấp khách hàng để phân bổ lượt chuyển đổi liên quan đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng một hành động chuyển đổi mặc định. Chỉ có hiệu lực khi đặt lệnh callconversionReportingEnabled thành true.

ConversionTrackingSetting

Tập hợp các chế độ cài đặt của toàn khách hàng liên quan đến tính năng Theo dõi lượt chuyển đổi của Google Ads.

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "acceptedCustomerDataTerms": boolean, "conversionTrackingStatus": enum (`ConversionTrackingStatus`), "enhancedConversionsForLeadsEnabled": boolean, "googleAdsConversionCustomer": string, "conversionTrackingId": string, "crossAccountConversionTrackingId": string }

{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}

Các trường
`acceptedCustomerDataTerms`	`boolean` Chỉ có đầu ra. Liệu khách hàng đã chấp nhận các điều khoản về dữ liệu khách hàng hay chưa. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này chỉ để đọc. Để biết thêm thông tin, hãy xem https://support.google.com/adspolicy/answer/7475709.
`conversionTrackingStatus`	`enum (ConversionTrackingStatus)` Chỉ có đầu ra. Trạng thái theo dõi lượt chuyển đổi. Mã này cho biết liệu khách hàng có đang sử dụng tính năng theo dõi lượt chuyển đổi hay không và ai là chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này. Nếu khách hàng này đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị được trả về sẽ khác nhau dựa trên `login-customer-id` của yêu cầu.
`enhancedConversionsForLeadsEnabled`	`boolean` Chỉ có đầu ra. Khách hàng có chọn sử dụng tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng hay không. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này chỉ để đọc.
`googleAdsConversionCustomer`	`string` Chỉ có đầu ra. Tên tài nguyên của khách hàng nơi lượt chuyển đổi được tạo và quản lý. Trường này chỉ để đọc.
`conversionTrackingId`	`string (int64 format)` Chỉ có đầu ra. Mã theo dõi lượt chuyển đổi được sử dụng cho tài khoản này. Mã này không cho biết liệu khách hàng có sử dụng tính năng theo dõi lượt chuyển đổi hay không (conversionTrackingStatus có sử dụng). Trường này chỉ để đọc.
`crossAccountConversionTrackingId`	`string (int64 format)` Chỉ có đầu ra. Mã theo dõi lượt chuyển đổi của người quản lý của khách hàng. Mã này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản và ghi đè conversionTrackingId. Bạn chỉ có thể quản lý trường này thông qua giao diện người dùng Google Ads. Trường này chỉ để đọc.

ConversionTrackingStatus

Trạng thái Theo dõi lượt chuyển đổi của khách hàng.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`NOT_CONVERSION_TRACKED`	Khách hàng không sử dụng bất kỳ tính năng theo dõi lượt chuyển đổi nào.
`CONVERSION_TRACKING_MANAGED_BY_SELF`	Các hành động chuyển đổi do khách hàng này tạo và quản lý.
`CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER`	Các hành động chuyển đổi được tạo và quản lý bởi người quản lý được chỉ định trong `login-customer-id` của yêu cầu.
`CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER`	Các hành động chuyển đổi do người quản lý tạo và quản lý, khác với khách hàng hoặc người quản lý được chỉ định trong `login-customer-id` của yêu cầu.

RemarketingSetting

Cài đặt tái tiếp thị cho khách hàng.

Biểu diễn dưới dạng JSON
{ "googleGlobalSiteTag": string }

Các trường

Các trường
`googleGlobalSiteTag`	`string` Chỉ có đầu ra. Thẻ Google.

googleGlobalSiteTag

string

Chỉ có đầu ra. Thẻ Google.

CustomerPayPerConversionEligibilityFailureReason

Enum mô tả các lý do có thể khiến khách hàng không đủ điều kiện sử dụng PaymentMode.lpurl.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`NOT_ENOUGH_CONVERSIONS`	Khách hàng không có đủ số lượt chuyển đổi.
`CONVERSION_LAG_TOO_HIGH`	Độ trễ chuyển đổi của khách hàng quá cao.
`HAS_CAMPAIGN_WITH_SHARED_BUDGET`	Khách hàng sử dụng ngân sách dùng chung.
`HAS_UPLOAD_CLICKS_CONVERSION`	Khách hàng có các lượt chuyển đổi có conversionActionType.UPLOAD_clicks.
`AVERAGE_DAILY_SPEND_TOO_HIGH`	Mức chi tiêu trung bình hằng ngày của khách hàng quá cao.
`ANALYSIS_NOT_COMPLETE`	Máy chủ phụ trợ của Google Ads chưa tính toán liệu Khách hàng có đủ điều kiện sử dụng hay không. Hãy sớm quay lại nhé!
`OTHER`	Khách hàng không đủ điều kiện vì những lý do khác.

CustomerAgreementSetting

Cài đặt Thỏa thuận khách hàng cho một khách hàng.

Biểu diễn dưới dạng JSON
{ "acceptedLeadFormTerms": boolean }

Các trường

Các trường
`acceptedLeadFormTerms`	`boolean` Chỉ có đầu ra. Liệu khách hàng đã chấp nhận điều khoản dịch vụ của biểu mẫu khách hàng tiềm năng hay chưa.

acceptedLeadFormTerms

boolean

Chỉ có đầu ra. Liệu khách hàng đã chấp nhận điều khoản dịch vụ của biểu mẫu khách hàng tiềm năng hay chưa.

LocalServicesSettings

Chế độ cài đặt cho khách hàng Dịch vụ địa phương.

Biểu diễn dưới dạng JSON
{ "granularLicenseStatuses": [ { object (`GranularLicenseStatus`) } ], "granularInsuranceStatuses": [ { object (`GranularInsuranceStatus`) } ] }

Các trường

Các trường
`granularLicenseStatuses[]`	`object (GranularLicenseStatus)` Chỉ có đầu ra. Danh sách chỉ có thể đọc về các trạng thái giấy phép theo ngành dọc địa lý.
`granularInsuranceStatuses[]`	`object (GranularInsuranceStatus)` Chỉ có đầu ra. Danh sách chỉ có thể đọc về các trạng thái bảo hiểm cấp ngành dọc theo vị trí địa lý.

granularLicenseStatuses[]

object (GranularLicenseStatus)

Chỉ có đầu ra. Danh sách chỉ có thể đọc về các trạng thái giấy phép theo ngành dọc địa lý.

granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Chỉ có đầu ra. Danh sách chỉ có thể đọc về các trạng thái bảo hiểm cấp ngành dọc theo vị trí địa lý.

GranularLicenseStatus

Trạng thái giấy phép ở cấp địa lý + ngành dọc.

Biểu diễn dưới dạng JSON
{ "geoCriterionId": string, "categoryId": string, "verificationStatus": enum (`LocalServicesVerificationStatus`) }

Các trường

Các trường
`geoCriterionId`	`string (int64 format)` Chỉ có đầu ra. Mã tiêu chí mục tiêu theo địa lý được liên kết với trạng thái. Có thể ở cấp địa lý quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy truy cập vào https://developers.google.com/google-ads/api/data/geotargets để biết thêm thông tin.
`categoryId`	`string` Chỉ có đầu ra. Danh mục dịch vụ được liên kết với trạng thái. Ví dụ: xcat:service_area_business_ băng Để biết thêm chi tiết, hãy xem bài viết: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
`verificationStatus`	`enum (LocalServicesVerificationStatus)` Chỉ có đầu ra. Trạng thái giấy phép chi tiết, theo vị trí địa lý + ngành dọc.

geoCriterionId

string (int64 format)

Chỉ có đầu ra. Mã tiêu chí mục tiêu theo địa lý được liên kết với trạng thái. Có thể ở cấp địa lý quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy truy cập vào https://developers.google.com/google-ads/api/data/geotargets để biết thêm thông tin.

categoryId

string

Chỉ có đầu ra. Danh mục dịch vụ được liên kết với trạng thái. Ví dụ: xcat:service_area_business_ băng Để biết thêm chi tiết, hãy xem bài viết: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids

verificationStatus

enum (LocalServicesVerificationStatus)

Chỉ có đầu ra. Trạng thái giấy phép chi tiết, theo vị trí địa lý + ngành dọc.

LocalServicesVerificationStatus

Enum mô tả trạng thái của một danh mục xác minh Quảng cáo Dịch vụ địa phương cụ thể.

Enum
`UNSPECIFIED`	Chưa xác định.
`UNKNOWN`	Trạng thái xác minh không xác định.
`NEEDS_REVIEW`	Quy trình xác minh đã bắt đầu, nhưng chưa hoàn tất.
`FAILED`	Không xác minh được.
`PASSED`	Đã xác minh xong.
`NOT_APPLICABLE`	Không thể xác minh.
`NO_SUBMISSION`	Bạn cần xác minh nhưng đang chờ gửi.
`PARTIAL_SUBMISSION`	Bạn chưa gửi hết các phương thức xác minh bắt buộc.
`PENDING_ESCALATION`	Quy trình xác minh cần được Chuyên gia vận hành quảng cáo Dịch vụ địa phương xem xét.

GranularInsuranceStatus

Tình trạng bảo hiểm ở cấp địa lý + ngành dọc.

Biểu diễn dưới dạng JSON
{ "geoCriterionId": string, "categoryId": string, "verificationStatus": enum (`LocalServicesVerificationStatus`) }

Các trường

Các trường
`geoCriterionId`	`string (int64 format)` Chỉ có đầu ra. Mã tiêu chí mục tiêu theo địa lý được liên kết với trạng thái. Có thể ở cấp địa lý quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy truy cập vào https://developers.google.com/google-ads/api/data/geotargets để biết thêm thông tin.
`categoryId`	`string` Chỉ có đầu ra. Danh mục dịch vụ được liên kết với trạng thái. Ví dụ: xcat:service_area_business_ băng Để biết thêm chi tiết, hãy xem bài viết: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
`verificationStatus`	`enum (LocalServicesVerificationStatus)` Chỉ có đầu ra. Tình trạng bảo hiểm chi tiết, theo vị trí địa lý + ngành dọc.

geoCriterionId

string (int64 format)

categoryId

string

verificationStatus

enum (LocalServicesVerificationStatus)

Chỉ có đầu ra. Tình trạng bảo hiểm chi tiết, theo vị trí địa lý + ngành dọc.