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
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`) }, "videoBrandSafetySuitability": enum (`BrandSafetySuitability`), "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)
  },
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "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
}

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 khách hàng.
`remarketingSetting`	`object (RemarketingSetting)` Chỉ có đầu ra. Chế độ 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.CONVERSION. 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 của tất cả khách hàng của `Customer.optimization_score * Customer.optimization_score_weight`. Trường này là 0 đối với tất cả khách hàng là người quản lý và đối với những khách hàng không phải người quản lý chưa được tính đ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 khách hàng.
`localServicesSettings`	`object (LocalServicesSettings)` Chỉ có đầu ra. Các chế độ cài đặt dành cho khách hàng Dịch vụ địa phương.
`videoBrandSafetySuitability`	`enum (BrandSafetySuitability)` Chỉ có đầu ra. Chế độ cài đặt An toàn thương hiệu ở cấp tài khoản. Cho phép chọn một loại khoảng không quảng cáo để hiển thị quảng cáo trên những nội dung phù hợp với thương hiệu của bạn. Hãy xem https://support.google.com/google-ads/answer/7515513.
`id`	`string (int64 format)` Chỉ có đầu ra. Mã của khách hàng.
`descriptiveName`	`string` Tên mô tả không bắt buộc và 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. Có hỗ trợ một số mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217.
`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 ngoài 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à false. Để biết thêm thông tin, hãy tham khảo 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 mức độ hiệu quả của 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 những khách hàng không phải người quản lý chưa được tính đ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 thời điểm di chuyển từ vị trí dựa trên nguồn cấp dữ liệu sang vị trí cơ sở của thành phần ở định dạng yyyy-MM-dd HH:mm:ss.
`imageAssetAutoMigrationDoneDateTime`	`string` Chỉ có đầu ra. Dấu thời gian của thời điểm di chuyển từ hình ảnh dựa trên nguồn cấp dữ liệu sang hình ảnh cơ sở 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 }

Trường

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 của Google.
`callConversionReportingEnabled`	`boolean` Liệu có bật tính năng báo cáo lượt chuyển đổi dẫn đến 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 dẫn đế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 callConversionReportingEnabled được đặt 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 của Google.

callConversionReportingEnabled

boolean

Liệu có bật tính năng báo cáo lượt chuyển đổi dẫn đến 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 dẫn đế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 callConversionReportingEnabled được đặt thành true.

ConversionTrackingSetting

Tập hợp các chế độ cài đặt trên 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
}

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. Thông tin này cho biết 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à chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này là ai. 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ị 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. Liệu 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 các 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 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). 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 đè mã theo dõi lượt chuyển đổi. 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.

RemarketingSetting

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

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

Trường

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.nhiều.

Enum
`UNSPECIFIED`	Chưa chỉ đị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ễ của lượt 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ó 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`	Phần phụ trợ của Google Ads chưa tính toán tình trạng đủ điều kiện của khách hà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 khách hàng.

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

Trường

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

Các chế độ cài đặt dành 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`) } ] }

Trường

Trường
`granularLicenseStatuses[]`	`object (GranularLicenseStatus)` Chỉ có đầu ra. Danh sách chỉ có thể đọc về trạng thái giấy phép cấp địa lý theo ngành dọc.
`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 địa lý theo ngành dọc.

granularLicenseStatuses[]

object (GranularLicenseStatus)

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

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 địa lý theo ngành dọc.

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`) }

Trường

Trường
`geoCriterionId`	`string (int64 format)` Chỉ có đầu ra. ID tiêu chí mục tiêu địa lý được liên kết với trạng thái. Có thể tuỳ thuộc vào cấp địa lý của quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy tham khả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_link. Để 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 khu vực địa lý + ngành dọc.

geoCriterionId

string (int64 format)

Chỉ có đầu ra. ID tiêu chí mục tiêu địa lý được liên kết với trạng thái. Có thể tuỳ thuộc vào cấp địa lý của quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy tham khả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_link. Để 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 khu vực đị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 chỉ đị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 kết thúc.
`FAILED`	Không xác minh được.
`PASSED`	Đã xác minh xong.
`NOT_APPLICABLE`	Không thể áp dụng quy trình 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 tất cả thông tin xác minh bắt buộc.
`PENDING_ESCALATION`	Việc 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`) }

Trường

Trường
`geoCriterionId`	`string (int64 format)` Chỉ có đầu ra. ID tiêu chí mục tiêu địa lý được liên kết với trạng thái. Có thể tuỳ thuộc vào cấp địa lý của quốc gia hoặc tiểu bang/tỉnh, tuỳ thuộc vào yêu cầu và vị trí. Hãy tham khả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_link. Để 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.