FetchAndJoinCustomAudienceRequest

public final class FetchAndJoinCustomAudienceRequest
extends Object

java.lang.Object
   ↳ android.adservices.customaudience.FetchAndJoinCustomAudienceRequest

要求物件，可包裝擷取 CustomAudience 所需的必要和選用參數。

fetchUri 是唯一的必要參數，代表要從哪個 URI 擷取自訂目標對象。name、activationTime、expirationTime 和 userBiddingSignals 是選用參數，代表一部分的自訂目標對象，呼叫端可以運用這些自訂目標對象，判斷使用者應加入何種自訂目標對象。從 fetchUri 擷取的自訂目標對象無法覆寫呼叫端設定的任何欄位。如要進一步瞭解每個欄位，請參閱 CustomAudience。

摘要

巢狀類別

class FetchAndJoinCustomAudienceRequest.Builder

FetchAndJoinCustomAudienceRequest 物件的建構工具。 

公用方法

boolean equals(Object o)

指出是否有其他物件「等於」這個。

Instant getActivationTime()

詳見 CustomAudience#getActivationTime()。

Instant getExpirationTime()

詳見 CustomAudience#getExpirationTime()。

Uri getFetchUri()
String getName()

詳見 CustomAudience#getName()。

AdSelectionSignals getUserBiddingSignals()

詳見 CustomAudience#getUserBiddingSignals()。

int hashCode()

傳回該物件的雜湊碼值。

String toString()

傳回該物件的字串表示法。

繼承方法

公用方法

equals

public boolean equals (Object o)

指出是否有其他物件「等於」這個物件。

equals 方法針對非空值物件參照實作對等關係：

  • 如果是自反關係：針對任何的非空參照值 x，x.equals(x) 應傳回 true。
  • 如果是對稱關係：針對任何非空參照值 x 和 y，x.equals(y) 應傳回 true，前提是 y.equals(x) 必須傳回 true。
  • 如果是可轉換關係：針對任何非空參照值 x、y 和 z，如果 x.equals(y) 傳回 true，且 y.equals(z) 傳回 true，則 x.equals(z) 應傳回 true。
  • 如果是一致的關係：針對任何非空參照值 x 和 y，多次叫用 x.equals(y) 會持續傳回 true 或 false，但前提是，在該物件的 equals 比較中所使用的資訊均未經過修改。
  • 針對任何非空參照值 x，x.equals(null) 應傳回 false。

類別 Object 的 equals 方法可對物件實作最明顯的對等關係；也就是說，針對任何非空參照值 x 和 y，只有在 x 和 y 參照相同的物件時 (x == y 的值為 true)，此方法才會傳回 true。

請注意，通常情況下，只要覆寫這個方法，就必須覆寫 hashCode 方法，以便維持 hashCode 方法的通用協定，亦即相等的物件必須有相等的雜湊碼。

參數
o Object：要用來比較的參照物件。
傳回
boolean true：如果兩個 FetchAndJoinCustomAudienceRequest 物件包含相同的資訊。

getActivationTime

public Instant getActivationTime ()

詳見 CustomAudience#getActivationTime()。

傳回
Instant Instant 是加入自訂目標對象將會延遲的時刻， 值可以是 null。

getExpirationTime

public Instant getExpirationTime ()

詳見 CustomAudience#getExpirationTime()。

傳回
Instant Instant 是自訂目標對象成員資格將失效的時刻， 值可以是 null。

getFetchUri

public Uri getFetchUri ()

傳回
Uri 要被擷取自訂目標對象的 Uri。 此值不能為 null。

getName

public String getName ()

詳見 CustomAudience#getName()。

傳回
String 要加入的自訂目標對象的 String 名稱。 值可以是 null。

getUserBiddingSignals

public AdSelectionSignals getUserBiddingSignals ()

詳見 CustomAudience#getUserBiddingSignals()。

傳回
AdSelectionSignals 在自訂交易時，買方提供的 JavaScript 所使用的買方信號 目標對象參與廣告選擇程序 這個值可以是 null。

hashCode

public int hashCode ()

傳回該物件的雜湊碼值。此方法支援使用雜湊資料表，例如 HashMap 提供的雜湊資料表。

hashCode 的一般約定如下：

  • 在 Java 應用程式執行期間，如果多次叫用同一物件，hashCode 方法必須持續傳回相同的整數；前提是在該物件上用於 equals 比較的資訊均未經修改。在同一個應用程式兩次執行作業之間，此整數無需保持一致。
  • 如果根據 equals(Object) 方法，兩個物件是相同的，則針對兩個物件呼叫 hashCode 方法時，必須產生相同的整數結果。
  • 如果根據 equals(java.lang.Object) 方法，兩個物件不相同，則針對兩個物件呼叫 hashCode 方法時，無需產生不同的整數結果。不過，程式設計人員也應瞭解，如果為不相等的物件產生不同的整數結果，可能會改善雜湊資料表的效能。

只要合理可行，類別 Object 定義的 hashCode 方法會針對不同的物件傳回不同的整數 (在某個時間點上，hashCode 不一定會實作為物件記憶體位址的某個函式)。

傳回
int FetchAndJoinCustomAudienceRequest 物件資料的雜湊。

toString

public String toString ()

傳回該物件的字串表示法。一般來說，toString 方法會傳回「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要，並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。

類別 Object 的 toString 方法會傳回一個字串，當中包含物件為例項的類別名稱、「@」符號字元，以及物件雜湊程式碼的不帶正負號十六進位表示法。換句話說，此方法會傳回等於下列值的字串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())

傳回
String 人類可讀的 FetchAndJoinCustomAudienceRequest 表示法。