本頁面由 Cloud Translation API 翻譯而成。

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 )` 您可以使用這個方法，將應用程式標記為採用受限的資料處理模式，針對歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者。
`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
)

您可以使用這個方法，將應用程式標記為採用受限的資料處理模式，適用於歐洲經濟區 (EEA) 境內未滿法定同意年齡的使用者。這項功能的立意是協助發布商遵守《一般資料保護規則》(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`