Google 검색 진입점 사용

Google 검색으로 그라운딩을 사용하려면 Google 검색 진입점을 사용 설정해야 합니다.

Google 검색 진입점을 사용하려면 그라운딩된 응답의 메타데이터에 포함된 검색어를 기준으로 진입점을 표시해야 합니다. 응답에 다음이 포함됩니다.

  • 'content': LLM에서 생성한 응답입니다.
  • 'searchQuery': Google 검색 진입점에 사용할 쿼리입니다.

예를 들어 다음 코드 스니펫에서 Gemini는 열대 식물 유형을 묻는 Google 검색 그라운딩된 프롬프트에 응답합니다.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Google 검색 진입점을 사용하여 이 출력을 가져와 표시할 수 있습니다.

Google 검색 진입점 요구사항

해야 할 일:

  • 아래의 디스플레이 요구사항을 준수하면서 진입점을 수정하지 않고 제공된 대로 정확하게 표시할 것
  • 사용자가 진입점과 상호작용할 때 Google 검색 결과 페이지(SRP)로 직접 가져올 것

하지 말아야 할 일:

  • 사용자 탭과 SRP 디스플레이 사이에 전면 광고 화면이나 추가 단계를 포함하는 것
  • 진입점 또는 연결된 그라운딩된 LLM 응답과 함께 다른 검색 결과나 제안을 표시하는 것

디스플레이 요구사항

  • 진입점을 제공된 그대로 표시하고 색상, 글꼴 또는 모양을 수정하지 않습니다. 진입점이 밝은 모드와 어두운 모드를 포함하여 아래 모의에 지정된 대로 렌더링되는지 확인합니다.
  • 그라운딩된 응답이 표시될 때마다 해당 Google 검색 진입점이 계속 표시되어야 합니다.
  • 브랜딩: 서드 파티의 Google 브랜드 표시 사용에 대한 Google 가이드라인을 엄격하게 준수해야 합니다.
  • Google 검색 진입점은 최소한 그라운딩된 응답의 전체 너비여야 합니다.

탭할 때 동작

사용자가 칩을 탭하면 칩에 표시된 검색어의 Google 검색 결과 페이지(SRP)로 바로 이동합니다. SRP는 인앱 브라우저 또는 별도의 브라우저 앱에서 열 수 있습니다. 어떠한 방식으로든 SRP 디스플레이를 최소화, 삭제 또는 방해하지 않는 것이 중요합니다. 다음 애니메이션 목업에서는 탭-SRP 상호작용을 보여줍니다.

앱/데스크톱 예시

Google 검색 진입점을 구현하는 코드

API를 사용하여 검색에 대한 응답을 그라운딩하는 경우, 모델 응답은 애플리케이션에서 검색 입력 지점을 표시하기 위해 구현하는 renderedContent 필드에 호환되는 HTML 및 CSS 스타일을 제공합니다. API 응답의 예시를 보려면 Google 검색으로 그라운딩의 응답 섹션을 참조하세요.

다음 단계