La API de Fraud Defense Related Accounts te permite identificar las cuentas de usuario que muestran un comportamiento coordinado o relacionado en tu plataforma. La API organiza las cuentas relacionadas en grupos y membresías para ayudarte a detectar clústeres de cuentas falsas y evitar apropiaciones de cuentas automatizadas.
Esta función solo está disponible con la API de REST de reCAPTCHA y las bibliotecas cliente.
Recupera cuentas relacionadas con una cuenta específica
Para recuperar una lista de cuentas relacionadas con una cuenta especificada, usa el método relatedaccountgroupmemberships.search.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- ACCOUNT_ID: Es el identificador que se asocia de forma única con la cuenta de usuario de tu sitio web.
- PAGE_SIZE: Opcional Es la cantidad de membresías de cuenta que se incluirán en la respuesta. El valor predeterminado es 50 y el valor máximo es 1,000. Si la cantidad de membresías de la cuenta es mayor que el tamaño de la página, la respuesta contiene un token de paginación que puedes usar para consultar la siguiente página de resultados.
- NEXT_PAGE_TOKEN: Opcional Es el valor de
nextPageTokenque se devolvió en la respuesta anterior de este método. Especifica este parámetro para consultar más membresías de la cuenta.
Método HTTP y URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN
Cuerpo JSON de la solicitud:
{
"accountId": "ACCOUNT_ID"
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"relatedAccountGroupMemberships": [
{
"name": "projects/projectId/relatedaccountgroups/groupId187/memberships/membershipId95",
"accountId": "4RopXS59"
},
{
"name": "projects/projectId/relatedaccountgroups/groupId91/memberships/membershipId23",
"accountId": "HVMv1DTb"
}
],
"nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}
Muestra de código
Recupera grupos de cuentas relacionados
Para recuperar una lista de grupos de cuentas con comportamientos similares, usa el
método relatedaccountgroups.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- PAGE_SIZE: Opcional Es la cantidad de grupos de cuentas que se incluirán en la respuesta. El valor predeterminado es 50 y el valor máximo es 1,000. Si la cantidad de grupos de cuentas es mayor que el tamaño de la página, la respuesta contiene un token de paginación que puedes usar para consultar la siguiente página de resultados.
- NEXT_PAGE_TOKEN: Opcional Es el valor de
nextPageTokenque se mostró en una respuesta anterior de este método. Especifica este parámetro para consultar más grupos de cuentas.
Método HTTP y URL:
GET https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"relatedAccountGroups": [
{
"name": "projects/projectId/relatedaccountgroups/groupId1"
},
{
"name": "projects/projectId/relatedaccountgroups/groupId2"
}
],
"nextPageToken": "BenimQwKzIOibbOO2Lhisw"
}
Muestra de código
Recupera las membresías de grupos de cuentas relacionadas
Para recuperar una lista de membresías de grupos de cuentas con comportamientos similares, usa el método relatedaccountgroupmemberships.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud .
- GROUP_ID: Es el nombre del grupo de cuentas para el que deseas encontrar membresías relacionadas.
- PAGE_SIZE: Opcional Es la cantidad de membresías de grupos de cuentas que se incluirán en la respuesta. El valor predeterminado es 50 y el valor máximo es 1,000. Si la cantidad de membresías de grupos de cuentas es mayor que el tamaño de la página, la respuesta contiene un token de paginación que puedes usar para recuperar la siguiente página de resultados.
- NEXT_PAGE_TOKEN: Opcional Es el valor de
nextPageTokenque se devolvió en la respuesta anterior de este método. Especifica este parámetro para consultar más membresías de grupos de cuentas.
Método HTTP y URL:
GET https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"relatedAccountGroupMemberships": [
{
"name": "projects/projectId/relatedaccountgroups/groupId/memberships/membershipId1",
"accountId": "4RopXS59"
},
{
"name": "projects/projectId/relatedaccountgroups/groupId/memberships/membershipId2",
"accountId": "HVMv1DTb"
}
],
"nextPageToken": "WPuIn8GHU3JvcJqgvmE7Aw"
}
Muestra de código
¿Qué sigue?
Obtén información sobre las siguientes funciones de protección de la cuenta: