ConsentInformation

Kotlin |Java

public interface ConsentInformation

---

Các phương thức tiện ích để thu thập sự đồng ý của người dùng.

Tóm tắt

Loại lồng nhau
@Retention(value = SOURCE) @IntDef(value = [ConsentStatus.UNKNOWN, ConsentStatus.NOT_REQUIRED, ConsentStatus.REQUIRED, ConsentStatus.OBTAINED]) public annotation ConsentInformation.ConsentStatus Giá trị trạng thái đồng ý.
public interface ConsentInformation.OnConsentInfoUpdateFailureListener Định nghĩa giao diện cho lệnh gọi lại được gọi khi không cập nhật được thông tin về sự đồng ý.
public interface ConsentInformation.OnConsentInfoUpdateSuccessListener Định nghĩa giao diện cho lệnh gọi lại được gọi khi thông tin về sự đồng ý được cập nhật thành công.
public enum ConsentInformation.PrivacyOptionsRequirementStatus Trạng thái yêu cầu về các lựa chọn quyền riêng tư.

Phương thức công khai
abstract boolean	canRequestAds() Cho biết liệu SDK có thu thập được sự đồng ý phù hợp với thông báo đã định cấu hình của ứng dụng hay không.
abstract int	@ConsentInformation.ConsentStatus getConsentStatus() Lấy trạng thái đồng ý hiện tại.
abstract ConsentInformation.PrivacyOptionsRequirementStatus	getPrivacyOptionsRequirementStatus() Lấy trạng thái cho biết liệu có cần nút lựa chọn về quyền riêng tư hay không.
abstract boolean	isConsentFormAvailable() Trả về true nếu có ConsentForm, nếu không thì trả về false.
abstract void	requestConsentInfoUpdate(     Activity activity,     ConsentRequestParameters consentRequestParameters,     ConsentInformation.OnConsentInfoUpdateSuccessListener successListener,     ConsentInformation.OnConsentInfoUpdateFailureListener failureListener ) Yêu cầu cập nhật thông tin về sự đồng ý.
abstract void	reset() Đặt lại ConsentInformation về trạng thái đã khởi chạy.

Phương thức công khai

canRequestAds

abstract boolean canRequestAds()

Cho biết liệu SDK có thu thập được sự đồng ý phù hợp với thông báo đã định cấu hình của ứng dụng hay không.

Phương thức này trả về false cho đến khi requestConsentInfoUpdate được gọi.

Sau khi requestConsentInfoUpdate được gọi, phương thức này sẽ trả về true khi getConsentStatus trả về NOT_REQUIRED hoặc OBTAINED.

Giá trị trả về
boolean	true nếu SDK đã thu thập sự đồng ý phù hợp với thông báo đã định cấu hình của ứng dụng.

getConsentStatus

@ConsentInformation.ConsentStatus
abstract int getConsentStatus()

Lấy trạng thái đồng ý hiện tại.

Giá trị trả về
int	UNKNOWN cho đến khi requestConsentInfoUpdate được gọi và mặc định là giá trị của phiên trước cho đến khi requestConsentInfoUpdate hoàn tất thành công và OnConsentInfoUpdateSuccessListener được gọi.

getPrivacyOptionsRequirementStatus

abstract ConsentInformation.PrivacyOptionsRequirementStatus getPrivacyOptionsRequirementStatus()

Lấy trạng thái cho biết liệu có cần nút lựa chọn về quyền riêng tư hay không.

Giá trị trả về
ConsentInformation.PrivacyOptionsRequirementStatus	UNKNOWN cho đến khi requestConsentInfoUpdate được gọi và mặc định là giá trị của phiên trước cho đến khi requestConsentInfoUpdate hoàn tất thành công và được gọi.

isConsentFormAvailable

abstract boolean isConsentFormAvailable()

Trả về true nếu có ConsentForm, nếu không thì trả về false.

requestConsentInfoUpdate

abstract void requestConsentInfoUpdate(
    Activity activity,
    ConsentRequestParameters consentRequestParameters,
    ConsentInformation.OnConsentInfoUpdateSuccessListener successListener,
    ConsentInformation.OnConsentInfoUpdateFailureListener failureListener
)

Yêu cầu cập nhật thông tin về sự đồng ý.

Bạn phải gọi API này trong mỗi phiên ứng dụng trước khi gọi getConsentStatus.

Sau khi API này được gọi, giá trị trả về của API getConsentStatus sẽ được cập nhật đồng bộ để giữ trạng thái đồng ý từ phiên ứng dụng trước (nếu có).

getConsentStatus có thể được cập nhật lại thành trạng thái mới nhất sau khi được gọi.

Tham số
Activity activity	Hoạt động dùng để thu thập ảnh cắt màn hình.
ConsentRequestParameters consentRequestParameters	Tham số yêu cầu.
ConsentInformation.OnConsentInfoUpdateSuccessListener successListener	Trình nghe yêu cầu đồng ý thành công.
ConsentInformation.OnConsentInfoUpdateFailureListener failureListener	Trình nghe lỗi yêu cầu đồng ý.

Khôi phục tuỳ chọn tìm kiếm

abstract void reset()

Đặt lại ConsentInformation về trạng thái đã khởi chạy. Bạn chỉ nên sử dụng tính năng này để gỡ lỗi.