מספר מזהי לקוח

בשלב הזה, מזהה לקוח אחד יכול לתמוך רק בתכונת חיפוש אחת. אם רוצים להשתמש בכמה תכונות חיפוש באפליקציה, צריך להשתמש בכמה מזהי לקוח. בנוסף, אם רוצים להשתמש באותה תכונת חיפוש בנקודות כניסה שונות באפליקציה, צריך להשתמש במזהי לקוח שונים לכל אחת מהן כדי להבחין בין סוגי התנועה.

לכל בקשה, אפשר להגדיר מראש Client-ID ב-GetSearchSuggestionsOptions, ב-GetTrendingSearchesOptions או ב-GetSearchContentOptions, והמזהה הזה יחליף את Client-ID שמוגדר כברירת מחדל בקובץ Info.plist (רק עבור הבקשה הזו).

Swift

getSearchSuggestions(withOptions:)

Task {
    let options = GetSearchSuggestionsOptions(withTextContext:['Sample Query', 'Another query string'])
    options.clientId = "client id"
    let suggestions = try await searchRuntime.getSearchSuggestions(
            withOptions: options)
}

Objective-C

getSearchSuggestionsWithOptions

  GetSearchSuggestionsOptions *options = [[GetSearchSuggestionsOptions alloc] initWithTextContext: @[@'Sample Query', @'Another query string' ]];
  options.clientId = [NSString stringWithFormat:@"client id"];
  [searchRuntime
      getSearchSuggestionsWithOptions:options
                             completionHandler:^(SearchSuggestions *_Nullable suggestions,
                                                 NSError *_Nullable error) {
                              // error will be not null if there is an error.
                              // On success, suggestions will be non null.
                            }];