Rövid útmutató: Telefonszám operátoradatainak keresése az Azure Communication Services használatával
Fontos
Az Azure Communication Services ezen funkciója jelenleg előzetes verzióban érhető el.
Az előzetes verziójú API-k és SDK-k szolgáltatásszintű szerződés nélkül érhetők el. Javasoljuk, hogy éles számítási feladatokhoz ne használja őket. Előfordulhat, hogy egyes funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek.
További információkért tekintse át a Microsoft Azure Előzetes verzió kiegészítő használati feltételeit.
A JavaScripthez készült Telefon Numbers ügyfélkódtár első lépései a telefonszámok operátoradatainak kereséséhez, amelyek segítségével megállapíthatja, hogy az adott telefonszámmal kommunikálhat-e és hogyan. Az alábbi lépéseket követve telepítheti a csomagot, és megkereshet egy telefonszám operátoradatait.
Feljegyzés
Keresse meg a gitHubon a rövid útmutató kódját.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Node.js Active LTS (hosszú távú támogatás) és karbantartási LTS-verziók (8.11.1 és 10.14.1 ajánlott).
- Aktív Communication Services-erőforrás és kapcsolati sztring. Hozzon létre egy Communication Services-erőforrást.
Előfeltételek ellenőrzése
Egy terminál vagy parancsablakban futtassa a parancsot annak node --version ellenőrzéséhez, hogy a Node.js telepítve van-e.
Beállítás
A keresési lekérdezések küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.
Új Node.js-alkalmazás létrehozása
Egy terminál vagy parancsablakban hozzon létre egy új könyvtárat az alkalmazáshoz, és navigáljon hozzá.
mkdir number-lookup-quickstart && cd number-lookup-quickstart
Futtassa npm init -y az alapértelmezett beállításokkal rendelkező package.json fájl létrehozásához.
npm init -y
Hozzon létre egy number-lookup-quickstart.js nevű fájlt a létrehozott könyvtár gyökerében. Adja hozzá a következő kódrészletet:
async function main() {
// quickstart code will go here
}
main();
Telepítse a(z) csomagot
npm install A paranccsal telepítheti az Azure Communication Services Telefon Numbers ügyfélkódtárat JavaScripthez.
npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save
A --save beállítás függőségként adja hozzá a tárat a package.json fájlhoz.
Kódpéldák
Az ügyfél hitelesítése
Importálja a Telefon NumbersClientet az ügyfélkódtárból, és példányosíthatja a kapcsolati sztring, amelyet az Azure Portalon található Azure Communication Services-erőforrásból szerezhet be. COMMUNICATION_SERVICES_CONNECTION_STRING A környezeti változók használata ajánlott, hogy ne helyezze a kapcsolati sztring egyszerű szövegbe a kódban. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.
Adja hozzá a következő kódot a number-lookup-quickstart.js tetejére:
const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');
// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];
// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);
Telefonszámformázás keresése
A telefonszámok operátoradatainak kereséséhez hívja searchOperatorInformation fel a következőt: .PhoneNumbersClient>
let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);
Cserélje le <target-phone-number> a keresett telefonszámra, általában egy számra, amelynek üzenetet szeretne küldeni.
Figyelmeztetés
Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123.
Operátoradatok keresése számhoz
Ha egy telefonszám operátoradatait szeretné megkeresni, hívja searchOperatorInformation meg a PhoneNumbersClientlehetőséget a true includeAdditionalOperatorDetails megadott telefonszámról.
let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });
Figyelmeztetés
Ennek a funkciónak a használata díjköteles lesz a fiókjában.
Operátoradatok használata
Most már használhatja az operátor adatait. Ebben a rövid útmutatóban néhány részletet kinyomtathatunk a konzolra.
Először is kinyomtathatjuk a számformátum részleteit.
let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");
Ezután kinyomtathatjuk a telefonszám és az operátor adatait.
let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
+ operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));
Az operátor adataival azt is megállapíthatja, hogy sms-t szeretne-e küldeni. Az SMS küldésével kapcsolatos további információkért tekintse meg az SMS gyorsútmutatót.
A kód futtatása
Futtassa az alkalmazást a terminálból vagy a parancsablakból a node paranccsal.
node number-lookup-quickstart.js
Mintakód
A C# Telefon Numbers ügyfélkódtárának első lépései a telefonszámok operátoradatainak kereséséhez, amelyek segítségével megállapíthatja, hogy az adott telefonszámmal kommunikálhat-e és hogyan. Az alábbi lépéseket követve telepítheti a csomagot, és megkereshet egy telefonszám operátoradatait.
Feljegyzés
Keresse meg a gitHubon a rövid útmutató kódját.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- A .NET Core-ügyfélkódtár legújabb verziója az operációs rendszerhez.
- Aktív Communication Services-erőforrás és kapcsolati sztring. Hozzon létre egy Communication Services-erőforrást.
Előfeltételek ellenőrzése
Egy terminál vagy parancsablakban futtassa a dotnet parancsot a .NET SDK telepítésének ellenőrzéséhez.
Beállítás
A keresési lekérdezések küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.
Új C#-alkalmazás létrehozása
Egy terminál vagy parancsablakban futtassa a dotnet new parancsot egy új konzolalkalmazás létrehozásához a névvel NumberLookupQuickstart. Ez a parancs létrehoz egy egyszerű ""Helló világ!" alkalmazás" C#-projektet egyetlen forrásfájllal, Program.cs.
dotnet new console -o NumberLookupQuickstart
Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára, és használja a dotnet build parancsot az alkalmazás fordításához.
cd NumberLookupQuickstart
dotnet build
Csatlakozás csomagcsatorna fejlesztése
Az SDK nyilvános előzetes verziója közzé lesz téve egy fejlesztői csomagcsatornában. A fejlesztői hírcsatornát a NuGet parancssori felülettel adhatja hozzá, amely hozzáadja a NuGet.Config fájlhoz.
nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"
A fejlesztési csatornához való csatlakozással kapcsolatos további információk és egyéb lehetőségek a közreműködői útmutatóban találhatók.
Telepítse a(z) csomagot
Amíg az alkalmazáskönyvtárban marad, telepítse az Azure Communication Services Telefon Numbers ügyfélkódtárat a .NET-csomaghoz az alábbi paranccsal.
dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5
Adjon hozzá egy direktívát using a Program.cs elejéhez, hogy belefoglalja a névteret Azure.Communication .
using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;
A függvény aláírásának frissítése Main aszinkron módon.
internal class Program
{
static async Task Main(string[] args)
{
...
}
}
Kódpéldák
Az ügyfél hitelesítése
Telefon Szám ügyfelek hitelesítése az Azure Portalon található Azure Communication Services-erőforrásból beszerzett kapcsolati sztring használatával végezhető el. COMMUNICATION_SERVICES_CONNECTION_STRING A környezeti változók használata ajánlott, hogy ne helyezze a kapcsolati sztring egyszerű szövegbe a kódban. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.
// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");
PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));
Telefon Szám ügyfelek Microsoft Entra-hitelesítéssel is hitelesíthetők. Ezzel a beállítással a AZURE_CLIENT_SECRET, AZURE_CLIENT_IDés AZURE_TENANT_ID környezeti változókat be kell állítani a hitelesítéshez.
// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);
Telefonszámformázás keresése
Ha meg szeretné keresni egy szám nemzeti és nemzetközi formázását, hívja SearchOperatorInformationAsync meg a következőt: .PhoneNumbersClient>
OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });
Cserélje le <target-phone-number> a keresett telefonszámra, általában egy számra, amelynek üzenetet szeretne küldeni.
Figyelmeztetés
Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123.
Operátoradatok keresése számhoz
Ha egy telefonszám operátoradatait szeretné megkeresni, hívja SearchOperatorInformationAsync meg a PhoneNumbersClientlehetőséget a true IncludeAdditionalOperatorDetails megadott telefonszámról.
OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });
Figyelmeztetés
Ennek a funkciónak a használata díjköteles lesz a fiókjában.
Operátoradatok használata
Most már használhatja az operátor adatait. Ebben a rövid útmutatóban néhány részletet kinyomtathatunk a konzolra.
Először is kinyomtathatjuk a számformátum részleteit.
OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");
Ezután kinyomtathatjuk a telefonszám és az operátor adatait.
OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");
Az operátor adataival azt is megállapíthatja, hogy sms-t szeretne-e küldeni. Az SMS küldésével kapcsolatos további információkért tekintse meg az SMS gyorsútmutatót.
A kód futtatása
Futtassa az alkalmazást a terminálból vagy a parancsablakból a dotnet run paranccsal.
dotnet run --interactive
Mintakód
A mintaalkalmazást a GitHubról töltheti le.
Első lépések a Java Telefon Numbers ügyfélkódtárával a telefonszámok operátoradatainak kereséséhez, amelyek segítségével meghatározhatja, hogy a telefonszámmal kommunikáljon-e és hogyan. Az alábbi lépéseket követve telepítheti a csomagot, és megkereshet egy telefonszám operátoradatait.
Feljegyzés
Keresse meg a gitHubon a rövid útmutató kódját.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- A Java Development Kit (JDK) 8- vagy újabb verziója.
- Apache Maven.
- Aktív Communication Services-erőforrás és kapcsolati sztring. Hozzon létre egy Communication Services-erőforrást.
Előfeltételek ellenőrzése
Egy terminál vagy parancsablakban futtassa a parancsot annak mvn -v ellenőrzéséhez, hogy a Maven telepítve van-e.
Beállítás
A keresési lekérdezések küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.
Új Java-alkalmazás létrehozása
Egy terminál vagy parancsablakban lépjen arra a könyvtárra, ahol létre szeretné hozni a Java-alkalmazást. Futtassa a következő parancsot a Java-projekt létrehozásához a maven-archetype-quickstart sablonból.
mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false
A "létrehozás" feladat létrehoz egy olyan könyvtárat, amelynek a neve megegyezik a artifactId. Ebben a könyvtárban az src/main/java könyvtár tartalmazza a projekt forráskódját, a src/test/java directory tesztforrást, a pom.xml fájl pedig a projekt projektobjektum-modelljét vagy POM-ját.
Csatlakozás csomagcsatorna fejlesztése
Az SDK nyilvános előzetes verziója közzé lesz téve egy fejlesztői csomagcsatornában. A fejlesztői hírcsatornához való csatlakozáshoz nyissa meg a pom.xml fájlt a szövegszerkesztőben, és adja hozzá a fejlesztői adattárat a pom.xml <repositories> és <distributionManagement> a hozzáfűzhető szakaszokhoz, ha még nem léteznek.
<repository>
<id>azure-sdk-for-java</id>
<url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
Előfordulhat, hogy hozzá kell adnia vagy szerkesztenie kell a fájlt a settings.xml következő helyen: ${user.home}/.m2
<server>
<id>azure-sdk-for-java</id>
<username>azure-sdk</username>
<password>[PERSONAL_ACCESS_TOKEN]</password>
</server>
Létrehozhat egy személyes hozzáférési jogkivonatot a Packaging olvasási és írási hatóköreivel, és beillesztheti a <password> címkébe.
A fejlesztői hírcsatornához való csatlakozással kapcsolatos további információk és egyéb lehetőségek itt találhatók.
Telepítse a(z) csomagot
Adja hozzá a következő függőségi elemeket a pom.xml fájlban lévő függőségek csoportjához.
<dependencies>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-common</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-communication-phonenumbers</artifactId>
<version>1.2.0-beta.3</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-core</artifactId>
<version>1.41.0</version>
</dependency>
</dependencies>
Ellenőrizze a properties szakaszt, hogy a projekt a Maven 1.8-ás vagy újabb verzióját célozza-e.
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
Kódpéldák
Az alkalmazás-keretrendszer beállítása
A projektkönyvtárból:
- Lépjen a /src/main/java/com/communication/lookup/quickstart könyvtárra
- Nyissa meg a App.java fájlt a szerkesztőben
System.out.println("Hello world!");Az utasítás cseréje- Irányelvek hozzáadása
import
A kezdéshez használja a következő kódot:
package com.communication.lookup.quickstart;
import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;
public class App
{
public static void main( String[] args ) throws IOException
{
System.out.println("Azure Communication Services - Number Lookup Quickstart");
// Quickstart code goes here
}
}
Az ügyfél hitelesítése
Az ügyfél hitelesíthető az Azure Portalon egy Azure Communication Services-erőforrásból beszerzett kapcsolati sztring használatával. COMMUNICATION_SERVICES_CONNECTION_STRING A környezeti változók használata ajánlott, hogy ne helyezze a kapcsolati sztring egyszerű szövegbe a kódban. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.
// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");
PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
.connectionString(connectionString)
.buildClient();
Másik lehetőségként a Microsoft Entra-hitelesítéssel is hitelesíthet. DefaultAzureCredentialBuilder A Microsoft Entra ID használatának legegyszerűbb módja a használat. Az erőforrás nevét egy Azure Communication Services-erőforrásból szerezheti be az Azure Portalon.
// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
.endpoint(endpoint)
.credential(new DefaultAzureCredentialBuilder().build())
.buildClient();
Telefonszámformázás keresése
Ha meg szeretné keresni egy szám nemzeti és nemzetközi formázását, hívja searchOperatorInformation meg a következőt: .PhoneNumbersClient>
ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");
// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);
Cserélje le <target-phone-number> a keresett telefonszámra, általában egy számra, amelynek üzenetet szeretne küldeni.
Figyelmeztetés
Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123.
Operátoradatok keresése számhoz
Ha egy telefonszám operátoradatait szeretné megkeresni, hívja searchOperatorInformationWithResponse meg a PhoneNumbersClientlehetőséget a true IncludeAdditionalOperatorDetails megadott telefonszámról.
OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);
Figyelmeztetés
Ennek a funkciónak a használata díjköteles lesz a fiókjában.
Operátoradatok használata
Most már használhatja az operátor adatait. Ebben a rövid útmutatóban néhány részletet kinyomtathatunk a konzolra.
Először is kinyomtathatjuk a számformátum részleteit.
System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
+ formattingInfo.getInternationalFormat() + " internationally, and "
+ formattingInfo.getNationalFormat() + " nationally");
Ezután kinyomtathatjuk a telefonszám és az operátor adatait.
String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
+ operatorInfo.getIsoCountryCode() + " by " + operatorName);
Az operátor adataival azt is megállapíthatja, hogy sms-t szeretne-e küldeni. Az SMS küldésével kapcsolatos további információkért tekintse meg az SMS gyorsútmutatót.
A kód futtatása
Futtassa az alkalmazást a terminálból vagy a parancsablakból a következő parancsokkal: Keresse meg a pom.xml fájlt tartalmazó könyvtárat, és fordítsa le a projektet.
mvn compile
Ezután hozza létre a csomagot.
mvn package
Az alkalmazás végrehajtásához használja a mvn parancsot.
mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
Mintakód
A mintaalkalmazást a GitHubról töltheti le.
A Python Telefon Numbers ügyfélkódtárának első lépései a telefonszámok operátoradatainak kereséséhez, amelyek segítségével megállapíthatja, hogy az adott telefonszámmal kommunikálhat-e és hogyan. Az alábbi lépéseket követve telepítheti a csomagot, és megkereshet egy telefonszám operátoradatait.
Feljegyzés
Keresse meg a gitHubon a rövid útmutató kódját.
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Python 3.7+.
- Aktív Communication Services-erőforrás és kapcsolati sztring. Hozzon létre egy Communication Services-erőforrást.
Előfeltételek ellenőrzése
Egy terminál vagy parancsablakban futtassa a parancsot annak python --version ellenőrzéséhez, hogy telepítve van-e a Python.
Beállítás
A keresési lekérdezések küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.
Új Python-alkalmazás létrehozása
Egy terminál vagy parancsablakban hozzon létre egy új könyvtárat az alkalmazáshoz, és navigáljon hozzá.
mkdir number-lookup-quickstart && cd number-lookup-quickstart
Egy szövegszerkesztővel hozzon létre egy fájlt number_lookup_sample.py a projekt gyökérkönyvtárában, és adja hozzá a következő kódot. A többi gyorsútmutató-kód a következő szakaszokban lesz hozzáadva.
import os
from azure.communication.phonenumbers import PhoneNumbersClient
try:
print('Azure Communication Services - Number Lookup Quickstart')
# Quickstart code goes here
except Exception as ex:
print('Exception:')
print(ex)
Telepítse a(z) csomagot
Miközben továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services Telefon Numbers Python-csomaghoz készült ügyfélkódtárat a pip install parancs használatával.
pip install azure-communication-phonenumbers==1.2.0b2
Kódpéldák
Az ügyfél hitelesítése
Az ügyfél hitelesíthető az Azure Portalon egy Azure Communication Services-erőforrásból beszerzett kapcsolati sztring használatával. COMMUNICATION_SERVICES_CONNECTION_STRING A környezeti változók használata ajánlott, hogy ne helyezze a kapcsolati sztring egyszerű szövegbe a kódban. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.
# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
print('Exception:')
print(ex)
Másik lehetőségként az ügyfél Microsoft Entra-hitelesítéssel is hitelesíthető. A Microsoft Entra ID használatának legegyszerűbb módja az DefaultAzureCredential objektum használata, amelyet a pip install parancs használatával telepíthet.
pip install azure-identity
Egy DefaultAzureCredential objektum létrehozásához rendelkeznie AZURE_CLIENT_IDkell , AZURE_CLIENT_SECRETés AZURE_TENANT_ID már környezeti változóként kell beállítania a regisztrált Microsoft Entra-alkalmazás megfelelő értékeit.
A környezeti változók lekérésével kapcsolatos további információkért megtudhatja, hogyan állíthat be egyszerű szolgáltatásneveket a parancssori felületről.
A azure-identity kódtár telepítése után folytathatja az ügyfél hitelesítését.
from azure.identity import DefaultAzureCredential
# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
credential = DefaultAzureCredential()
phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
print('Exception:')
print(ex)
Telefonszámformázás keresése
Ha meg szeretné keresni egy szám nemzeti és nemzetközi formázását, hívja search_operator_information meg a következőt: .PhoneNumbersClient>
formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")
Cserélje le <target-phone-number> a keresett telefonszámra, általában egy számra, amelynek üzenetet szeretne küldeni.
Figyelmeztetés
Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123.
Operátoradatok keresése számhoz
Ha egy telefonszám operátoradatait szeretné megkeresni, hívja search_operator_information meg a PhoneNumbersClientlehetőséget a True include_additional_operator_details megadott telefonszámról.
options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)
Figyelmeztetés
Ennek a funkciónak a használata díjköteles lesz a fiókjában.
Operátoradatok használata
Most már használhatja az operátor adatait. Ebben a rövid útmutatóban néhány részletet kinyomtathatunk a konzolra.
Először is kinyomtathatjuk a számformátum részleteit.
formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))
Ezután kinyomtathatjuk a telefonszám és az operátor adatait.
operator_information = operator_results.values[0]
number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
operator_name = "an unknown operator"
else:
operator_name = operator_information.operator_details.name
print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))
Az operátor adataival azt is megállapíthatja, hogy sms-t szeretne-e küldeni. Az SMS küldésével kapcsolatos további információkért tekintse meg az SMS gyorsútmutatót.
A kód futtatása
Futtassa az alkalmazást a terminálból vagy a parancsablakból a python paranccsal.
python number_lookup_sample.py
Mintakód
A mintaalkalmazást a GitHubról töltheti le.
Hibaelhárítás
Gyakori kérdések és problémák:
- Előfordulhat, hogy a környezeti változók módosításai nem lépnek érvénybe a már futó programokban. Ha azt tapasztalja, hogy a környezeti változók nem a várt módon működnek, próbálja meg bezárni és újra megnyitni a kód futtatásához és szerkesztéséhez használt programokat.
- A végpont által visszaadott adatokra különböző nemzetközi törvények és előírások vonatkoznak, ezért az eredmények pontossága több tényezőtől függ. Ezek a tényezők közé tartozik a szám portoltsága, az országkód és a hívó jóváhagyási állapota. Ezen tényezők alapján előfordulhat, hogy az operátor adatai nem érhetők el bizonyos telefonszámokhoz, vagy a telefonszám eredeti operátorát tükrözhetik, nem pedig az aktuális operátort.
Következő lépések
Ebben a rövid útmutatóban megtanulta, hogyan:
- Számformázás keresése
- Telefonszám operátoradatainak keresése
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: