RequestConfiguration.Builder

Kotlin |Java

public class RequestConfiguration.Builder

RequestConfiguration 的建構工具。

摘要

公用建構函式
`Builder()`

公用方法
`RequestConfiguration`	`build()` 可建構 `RequestConfiguration`。
`RequestConfiguration.Builder`	`@CanIgnoreReturnValue setMaxAdContentRating( @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating )` 設定廣告內容分級上限。
`RequestConfiguration.Builder`	`@CanIgnoreReturnValue setPublisherPrivacyPersonalizationState( RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState )` 設定發布商隱私權處理方式的個人化狀態。
`RequestConfiguration.Builder`	`@CanIgnoreReturnValue setTagForChildDirectedTreatment( @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment )` 這個方法可讓您指定應用程式是否應依《兒童網路隱私保護法》(COPPA) 規定 ( http://business.ftc.gov/privacy-and-security/childrens-privacy) 視為兒童導向。
`RequestConfiguration.Builder`	`@CanIgnoreReturnValue setTagForUnderAgeOfConsent( @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent )` 這個方法可讓您標記應用程式，針對歐洲經濟區境內未滿規定年齡的使用者，套用適當模式。
`RequestConfiguration.Builder`	`@CanIgnoreReturnValue setTestDeviceIds(@Nullable List<String> testDeviceIds)` 設定與測試裝置相應的測試裝置 ID 清單，這些裝置一律會要求放送測試廣告。

公用建構函式

Builder

public Builder()

公用方法

build

public RequestConfiguration build()

可建構 RequestConfiguration。

setMaxAdContentRating

@CanIgnoreReturnValue
public RequestConfiguration.Builder setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating
)

設定廣告內容分級上限。系統為您的應用程式傳回的 AdMob 廣告，就不會超過指定的內容分級上限。有效值為 MAX_AD_CONTENT_RATING_G、MAX_AD_CONTENT_RATING_PG、MAX_AD_CONTENT_RATING_T 和 MAX_AD_CONTENT_RATING_MA。

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
public RequestConfiguration.Builder setPublisherPrivacyPersonalizationState(
    RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState
)

設定發布商隱私權處理方式的個人化狀態。

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment
)

這個方法可讓您指定是否要依《兒童網路隱私保護法》(COPPA) 規定 ( http://business.ftc.gov/privacy-and-security/childrens-privacy) 將應用程式視為兒童導向。

如果將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE，即表示應用程式應根據《兒童網路隱私保護法》(COPPA) 視為兒童導向。

如果將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE，即表示根據《兒童網路隱私保護法》(COPPA)，應用程式不應視為兒童導向。

如未設定這個方法，或將這個方法設為 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED，廣告請求就不會指明應如何依據 COPPA 處理應用程式。

設定此方法，即表示您確認這項通知正確無誤，且您有權代表應用程式擁有者採取行動；同時您也瞭解如果濫用這項設定，可能導致 Google 帳戶遭到終止。

注意：這項指定操作可能需要經過一段時間才會在適當的 Google 服務中全面生效。

參數
`@RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment`	設為 `true`，表示應用程式應視為兒童導向。設為 `false`，表示應用程式不應視為兒童導向。

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent
)

這個方法可讓您標記應用程式，針對歐洲經濟區境內未滿規定年齡的使用者，套用適當模式。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意，您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟發布的指南並諮詢您的法律顧問。提醒您，Google 提供工具的用意是協助發布商遵守規定，而非方便發布商規避其法定義務。

使用這項功能時，所有廣告請求都會包含未滿規定年齡的歐洲使用者標記 (TFUA) 參數。這個參數會針對特定廣告請求，停用個人化廣告功能 (包括再行銷)，也會停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。

如果將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE，表示您希望以適合未滿規定年齡使用者的方式處理應用程式。

如果將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE，表示您不希望以適合未滿規定年齡使用者的方式處理應用程式。

如未設定這個方法，或將這個方法設為 TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED，應用程式就不會指出您希望以適合未滿規定年齡使用者的方式處理應用程式。

setTestDeviceIds

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTestDeviceIds(@Nullable List<String> testDeviceIds)

設定與測試裝置相應的測試裝置 ID 清單，這些裝置一律會要求放送測試廣告。發出第一個廣告請求時，系統會在 logcat 中記錄目前裝置的測試裝置 ID。

參數
`@Nullable List<String> testDeviceIds`	測試裝置 ID 清單。傳遞 `null` 即可清除清單。

傳回
`RequestConfiguration.Builder`	`Builder`